Join our biggest community event of the year—get a first look at Grafana 12, plus a science fair and sessions on Prometheus, OpenTelemetry, and more. Save 20% with 3+ or 10% when you bring a friend.
The experimental module k6/experimental/webcrypto has graduated, and its functionality is now available globally through the crypto object. The k6/experimental/webcrypto is deprecated and will be removed in the near future.
To migrate your scripts, remove the k6/experimental/webcrypto imports and use the crypto object instead.
A Promise that resolves to a new ArrayBuffer containing the encrypted 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
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;}