Back to Jose

Function: compactVerify()

docs/jws/compact/verify/functions/compactVerify.md

6.2.23.1 KB
Original Source

Function: compactVerify()

šŸ’— Help the project

Support from the community to continue maintaining and improving this module is welcome. If you find the module useful, please consider supporting the project by becoming a sponsor.

Call Signature

ā–ø compactVerify(jws, key, options?): Promise<CompactVerifyResult>

Verifies the signature and format of and afterwards decodes the Compact JWS.

This function is exported (as a named export) from the main 'jose' module entry point as well as from its subpath export 'jose/jws/compact/verify'.

Parameters

ParameterTypeDescription
jwsstring | Uint8ArrayCompact JWS.
keyUint8Array | CryptoKey | JWK | KeyObjectKey to verify the JWS with. See Algorithm Key Requirements.
options?VerifyOptionsJWS Verify options.

Returns

Promise<CompactVerifyResult>

Example

js
const jws =
  'eyJhbGciOiJFUzI1NiJ9.SXTigJlzIGEgZGFuZ2Vyb3VzIGJ1c2luZXNzLCBGcm9kbywgZ29pbmcgb3V0IHlvdXIgZG9vci4.kkAs_gPPxWMI3rHuVlxHaTPfDWDoqdI8jSvuSmqV-8IHIWXg9mcAeC9ggV-45ZHRbiRJ3obUIFo1rHphPA5URg'

const { payload, protectedHeader } = await jose.compactVerify(jws, publicKey)

console.log(protectedHeader)
console.log(new TextDecoder().decode(payload))

Call Signature

ā–ø compactVerify(jws, getKey, options?): Promise<CompactVerifyResult & ResolvedKey>

Parameters

ParameterTypeDescription
jwsstring | Uint8ArrayCompact JWS.
getKeyCompactVerifyGetKeyFunction resolving a key to verify the JWS with. See Algorithm Key Requirements.
options?VerifyOptionsJWS Verify options.

Returns

Promise<CompactVerifyResult & ResolvedKey>