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.subtle.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 a symmetric algorithm and the public key for an asymmetric 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

Specification Status Comment
Web Cryptography API
The definition of 'SubtleCrypto.verify()' in that specification.
Recommendation Initial definition.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support3712

34

32 — 341

112247
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support373712

34

32 — 341

2476.0

1. From version 32 until version 34 (exclusive): this feature is behind the dom.webcrypto.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

2. Returns CryptoOperation instead of Promise

See also

Document Tags and Contributors

Contributors to this page: fscholz, Dans24, abbycar, jyasskin, teoli, GreatCall-KayeK
Last updated by: fscholz,