The generateKey() generates a new cryptographic key and returns it as a CryptoKey object that can be used with the Web Crypto API.
Usage
Parameters
Name | Type | Description |
---|---|---|
algorithm | string, AesKeyGenParams or HmacKeyGenParams | The type of key to generate. Can be either a string with any of the currently supported algorithms: AES-CBC, AES-GCM, AES-CTR, and HMAC as value, or any of the AesKeyGenParams or HmacKeyGenParams objects. |
extractable | boolean | Whether the key can be exported using exportKey. |
keyUsages | Array<string> | An array of strings describing what operations can be performed with the key. Currently supported usages include encrypt, decrypt, sign, and verify. |
Return Value
A Promise that resolves with the generated key as a CryptoKey object.
Throws
Type | Description |
---|---|
SyntaxError | Raised when the keyUsages parameter is empty but the key is of type secret or private. |
Example
example-webcrypto-generateKey.js