Parse Method
Parses the compact serialized JWS string.
Syntax
jws.parse([callback])
Callback
The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).
The callback for this method is defined as:
function(err){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
This method parses, but does not verify, the JWS string.
Take care when using this method as no signature verification is performed. This method may be helpful in cases where information about the signature is contained within the payload, or for any other reason where the signature is not important.
If verification is desired, use Verify instead. It is not necessary to call this method before calling Verify. Verify will both parse and verify the message.
When calling this method the headers and payload are parsed. The HeaderParam and SignerInfo events will fire and the HeaderParam* properties will be populated. The payload will be written to the specified output location.
Input and Output Properties
The class will determine the source and destination of the input and output based on which properties are set.
The order in which the input properties are checked is as follows:
When a valid source is found the search stops. The order in which the output properties are checked is as follows:
- OutputFile
- OutputMessage: The output data is written to this property if no other destination is specified.