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

SubtleCrypto.decrypt()

· 52CE 我爱测

SubtleCrypto 接口的 **`decrypt()`** 方法用于解密加密数据。它以用于解密的key、一些可选的额外参数,以及待解密的数据(也称为“密文”)为参数;返回一个 Promise,会兑现解密后的数据(也称为“明文”)。

Web Crypto API

SubtleCrypto 接口的 decrypt() 方法用于解密加密数据。它以用于解密的key、一些可选的额外参数,以及待解密的数据(也称为“密文”)为参数;返回一个 Promise,会兑现解密后的数据(也称为“明文”)。

语法

decrypt(algorithm, key, data)

参数

  • algorithm

    • : 一个对象,用于指定使用的算法,以及任何需要的额外参数。额外提供的参数的值必须与对应的 SubtleCrypto.encrypt() 调用所传入的值相匹配。
      • 使用 RSA-OAEP,则传入 RsaOaepParams 对象。
      • 使用 AES-CTR,则传入 AesCtrParams 对象。
      • 使用 AES-CBC,则传入 AesCbcParams 对象。
      • 使用 AES-GCM,则传入 AesGcmParams 对象。
  • key

    • : 一个包含了密钥的 CryptoKey 对象,用于解密。
  • data

    • : 一个包含了待解密的数据(也称为ciphertext)的 ArrayBuffer、TypedArray 或 DataView 对象。

返回值

一个 Promise,会兑现一个包含明文的 ArrayBuffer。

异常

当遇到以下异常时,promise 将会被拒绝:

  • InvalidAccessError DOMException
    • : 当提供的密钥无法执行请求的操作时(如:解密算法无效,或对指定的解密算法提供了无效的密钥)。
  • OperationError DOMException
    • : 因特定的操作原因导致操作失败时(如:算法的参数大小无效,或解密密文时发生的错误)。

支持的算法

decrypt() 方法支持的算法与 encrypt() 方法所支持的相同。

示例

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

RSA-OAEP

以下代码使用 RSA-OAEP 解密 ciphertext。在 GitHub 中查看完整的代码。

function decryptMessage(privateKey, ciphertext) {
  return window.crypto.subtle.decrypt(
    { name: "RSA-OAEP" },
    privateKey,
    ciphertext,
  );
}

AES-CTR

以下代码使用计数器(CTR)模式的 AES 解密 ciphertext。请注意,counter 必须与加密时使用的值相匹配。在 GitHub 中查看完整的代码。

function decryptMessage(key, ciphertext) {
  return window.crypto.subtle.decrypt(
    { name: "AES-CTR", counter, length: 64 },
    key,
    ciphertext,
  );
}

AES-CBC

以下代码使用密码块链接(CBC)模式的 AES 解密 ciphertext。请注意,iv 必须与加密时使用的值相匹配。在 GitHub 中查看完整的代码。

function decryptMessage(key, ciphertext) {
  return window.crypto.subtle.decrypt({ name: "AES-CBC", iv }, key, ciphertext);
}

AES-GCM

以下代码使用伽罗瓦/计数器(GCM)模式的 AES 解密 ciphertext。请注意,iv 必须与加密时使用的值相匹配。在 GitHub 中查看完整的代码。

function decryptMessage(key, ciphertext) {
  return window.crypto.subtle.decrypt({ name: "AES-GCM", iv }, key, ciphertext);
}

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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