SubtleCrypto.verify()

The SubtleCrypto.verify() method returns a Promise of a Boolean value indicating if the signature given as parameter matches the text, algorithm and key also given as parameters.

Syntax

var result = crypto.verify(algo, key, signature, text2verify);

Parameters

• signature is a ArrayBuffer or an ArrayBufferView containing the signature to verify.
• text2verify is a ArrayBuffer or an ArrayBufferView containing the data whose signature as to be verified.
• key is a CryptoKey containing the key to be used to verify the signature. It is the secret key for synchronous algorithm and the public key for an asynchronous algorithm.
• algo is a DOMString defining the signature function to use. Supported values are: HMAC, RSASSA-PKCS1-v1_5, and ECDSA.

Return value

• result is a Promise that returns a Boolean indicating if the signature has been a success on success.

Exceptions

The promise is rejected when the following exception is encountered:

• InvalidAccessError when the encryption key is not a key for the requested verifying algorithm or when trying to use an algorithm that is either unknown or isn't suitable for a verify operation.

Specifications

Browser compatibility

See also

• Crypto and Crypto.subtle.
• SubtleCrypto, the interface it belongs to.