菜单
文档breadcrumb arrow Grafana k6breadcrumb arrow JavaScript APIbreadcrumb arrow k6/experimentalbreadcrumb arrow webcrypto
开源 RSS

webcrypto

注意

实验性模块 k6/experimental/webcrypto 已转正，其功能现已通过 crypto 对象 全局可用。k6/experimental/webcrypto 已被弃用，并将在不久的将来移除。

要迁移你的脚本，请删除 k6/experimental/webcrypto 导入，并改用 crypto 对象。

使用这个实验性模块，你可以在 k6 脚本中使用 WebCrypto API。但请注意，这个 API 尚未完全实现，一些算法和功能可能仍然缺失。

Web Crypto API 是一个 JavaScript API，用于执行加密操作，例如加密、解密、数字签名生成和验证，以及密钥生成和管理。它提供了一个标准接口来访问加密功能，这有助于确保加密操作的正确性和安全性。

API

该模块导出一个顶级 crypto 对象，包含以下属性和方法

接口/函数描述
getRandomValues用加密安全的随机值填充传入的 TypedArray。
randomUUID返回一个随机生成的 36 个字符长的 v4 UUID。
subtleSubtleCrypto 接口提供了对常见加密原语的访问，例如哈希、签名、加密或解密。

示例

JavaScript 
import { crypto } from 'k6/experimental/webcrypto';

export default async function () {
  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(new Uint8Array(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)
  );
}

function arrayBufferToHex(buffer) {
  return [...new Uint8Array(buffer)].map((x) => x.toString(16).padStart(2, '0')).join('');
}

function stringToArrayBuffer(str) {
  const buf = new ArrayBuffer(str.length * 2); // 2 bytes for each char
  const bufView = new Uint16Array(buf);
  for (let i = 0, strLen = str.length; i < strLen; i++) {
    bufView[i] = str.charCodeAt(i);
  }
  return buf;
}