大网数据广告活动
Web 标准与前端开发

SubtleCrypto.generateKey()

· 52CE 我爱测

SubtleCrypto 接口的 **`generateKey()`** 方法用于生成新的密钥(用于对称加密算法)或密钥对(用于非对称加密算法)。

Web Crypto API

SubtleCrypto 接口的 generateKey() 方法用于生成新的密钥(用于对称加密算法)或密钥对(用于非对称加密算法)。

语法

generateKey(algorithm, extractable, keyUsages)

参数

  • algorithm

  • extractable

    • : 一个布尔值,表示生成的密钥是否可被 SubtleCrypto.exportKey() 和 SubtleCrypto.wrapKey() 方法导出。
  • keyUsages

    • : 一个Array,表示生成出来的密钥可被用于做什么,数组元素可能的值有:
      • encrypt:密钥可用于SubtleCrypto.encrypt()消息。
      • decrypt:密钥可用于SubtleCrypto.decrypt()消息。
      • sign:密钥可用于对消息进行SubtleCrypto.sign()。
      • verify:密钥可用于SubtleCrypto.verify()签名。
      • deriveKey:密钥可用于SubtleCrypto.deriveKey()。
      • deriveBits:密钥可用于SubtleCrypto.deriveBits()。
      • wrapKey:密钥可用于SubtleCrypto.wrapKey()。
      • unwrapKey:密钥可用于SubtleCrypto.unwrapKey()。

返回值

一个 Promise,会兑现为 CryptoKey(用于对称加密算法)或 CryptoKeyPair(用于非对称加密算法)。

异常

当发生以下几种异常时,promise 会被拒绝:

  • SyntaxError DOMException
    • : 当结果是类型为 secret 或 private 的CryptoKey,但 keyUsages 参数为空时触发。
  • SyntaxError DOMException
    • : 当结果是CryptoKeyPair,但它的 privateKey.usages 属性为空时触发。

示例

[!NOTE] 你可以在 Github 上尝试可用的示例。

生成 RSA 密钥对

以下代码生成 RSA-OAEP 加密密钥对。在 GitHub 上查看完整代码。

let keyPair = await window.crypto.subtle.generateKey(
  {
    name: "RSA-OAEP",
    modulusLength: 4096,
    publicExponent: new Uint8Array([1, 0, 1]),
    hash: "SHA-256",
  },
  true,
  ["encrypt", "decrypt"],
);

生成椭圆曲线密钥对

以下代码生成 ECDSA 签名密钥对。在 GitHub 上查看完整代码。

let keyPair = await window.crypto.subtle.generateKey(
  {
    name: "ECDSA",
    namedCurve: "P-384",
  },
  true,
  ["sign", "verify"],
);

生成 HMAC 密钥

以下代码生成 HMAC 签名密钥。在 GitHub 上查看完整代码。

let key = await window.crypto.subtle.generateKey(
  {
    name: "HMAC",
    hash: { name: "SHA-512" },
  },
  true,
  ["sign", "verify"],
);

生成 AES 密钥

以下代码生成 AES-GCM 加密密钥。在 GitHub 上查看完整代码。

let key = await window.crypto.subtle.generateKey(
  {
    name: "AES-GCM",
    length: 256,
  },
  true,
  ["encrypt", "decrypt"],
);

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。