The countdown is on: Register today + save your seatLearn how to leverage new AI features and observability tools, attend technical deep dives. & leave with tips for growing your observability strategy. Seats are limited and in high demand, register now!
📢 Registration + agenda now live
Explore the latest Grafana Cloud and AI solutions, learn tips & tricks from demos and hands-on workshops, and get actionable advice to advance your observability strategy. Register now and get 50% off - limited tickets available (while they last!).
Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Defines the algorithm to use and any extra-parameters. The values given for the extra parameters must match those used in the corresponding [encrypt] call.
A Promise that resolves to a new ArrayBuffer containing the decrypted data.
Throws
Type
Description
InvalidAccessError
Raised when the requested operation is not valid with the provided key. For instance when an invalid encryption algorithm is used, or a key not matching the selected algorithm is provided.
OperationError
Raised when the operation failed for an operation-specific reason. For instance, if the algorithm size is invalid, or errors occurred during the process of decrypting the ciphertext.
Example
JavaScript
JavaScript
import{ crypto }from'k6/experimental/webcrypto';exportdefaultasyncfunction(){const plaintext =stringToArrayBuffer('Hello, World!');/**
* Generate a symmetric key using the AES-CBC algorithm.
*/const key =await crypto.subtle.generateKey({name:'AES-CBC',length:256,},true,['encrypt','decrypt']);/**
* Encrypt the plaintext using the AES-CBC key with
* have generated.
*/const iv = crypto.getRandomValues(newUint8Array(16));const ciphertext =await crypto.subtle.encrypt({name:'AES-CBC',iv: iv,},
key,
plaintext
);/**
* Decrypt the ciphertext using the same key to verify
* that the resulting plaintext is the same as the original.
*/const deciphered =await crypto.subtle.decrypt({name:'AES-CBC',iv: iv,},
key,
ciphertext
);
console.log('deciphered text == original plaintext: ',arrayBufferToHex(deciphered)===arrayBufferToHex(plaintext));}functionarrayBufferToHex(buffer){return[...newUint8Array(buffer)].map((x)=> x.toString(16).padStart(2,'0')).join('');}functionstringToArrayBuffer(str){const buf =newArrayBuffer(str.length *2);// 2 bytes for each charconst bufView =newUint16Array(buf);for(let i =0, strLen = str.length; i < strLen; i++){
bufView[i]= str.charCodeAt(i);}return buf;}