SubtleCrypto.decrypt()

algorithm

一个对象，用于指定使用的算法，以及任何需要的额外参数。额外提供的参数的值必须与对应的 encrypt() 调用所传入的值相匹配。

• 使用 RSA-OAEP，则传入 RsaOaepParams 对象。
• 使用 AES-CTR，则传入 AesCtrParams 对象。
• 使用 AES-CBC，则传入 AesCbcParams 对象。
• 使用 AES-GCM，则传入 AesGcmParams 对象。

key

一个包含了密钥的 CryptoKey 对象，用于解密。

data

一个包含了待解密的数据（也称为密文）的 ArrayBuffer、TypedArray 或 DataView 对象。

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

当遇到以下异常时，promise 将会被拒绝：

InvalidAccessError DOMException

当提供的密钥无法执行请求的操作时（如：解密算法无效，或对指定的解密算法提供了无效的密钥）。

OperationError DOMException

因特定的操作原因导致操作失败时（如：算法的参数大小无效，或解密密文时发生的错误）。

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

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

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

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

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

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

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

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

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

• SubtleCrypto.encrypt()。
• RFC 3447 规定了 RSAOAEP。
• NIST SP800-38A 规定了 CTR 模式。
• NIST SP800-38A 规定了 CBC 模式。
• NIST SP800-38D 规定了 GCM 模式。
• FIPS 198-1 规定了 HMAC。