subtle.importKey(format, keyData, algorithm, extractable, keyUsages)

版本历史

版本	变更
v24.8.0	KMAC algorithms are now supported.
v24.7.0	ML-KEM algorithms are now supported.
v24.7.0	ChaCha20-Poly1305 algorithm is now supported.
v24.7.0	ML-DSA algorithms are now supported.
v18.4.0, v16.17.0	Added `'Ed25519'`, `'Ed448'`, `'X25519'`, and `'X448'` algorithms.
v15.9.0	Removed `'NODE-DSA'` JWK import.
v15.0.0	新增于: v15.0.0

format <string> 必须是 'raw'、'pkcs8'、'spki'、'jwk'、'raw-secret'⁴、'raw-public'⁴ 或 'raw-seed'⁴ 之一。
keyData <ArrayBuffer> | <TypedArray> | <DataView> | <Buffer> | <Object>

algorithm <string> | <RsaHashedImportParams> | <EcKeyImportParams> | <HmacImportParams>

extractable <boolean>
keyUsages <string[]> 见主要用途。
返回：<Promise> 成功时会触发 <CryptoKey>。

此方法尝试将提供的 keyData 解释为给定的 format，使用提供的 algorithm、extractable 和 keyUsages 参数创建一个 <CryptoKey> 实例。如果导入成功，返回的 Promise 将会解析为键材料的 <CryptoKey> 表示。

🌐 This method attempts to interpret the provided keyData as the given format to create a <CryptoKey> instance using the provided algorithm, extractable, and keyUsages arguments. If the import is successful, the returned promise will be resolved with a <CryptoKey> representation of the key material.

如果导入 KDF 算法的密钥，extractable 必须为 false。

🌐 If importing KDF algorithm keys, extractable must be false.

目前支持的算法包括：

🌐 The algorithms currently supported include:

| --- | --- | --- | --- | --- | --- | --- | --- |

| 'AES-CBC' | | | ✔ | ✔ | ✔ | | |

| 'AES-CTR' | | | ✔ | ✔ | ✔ | | |

| 'AES-GCM' | | | ✔ | ✔ | ✔ | | |

| 'AES-KW' | | | ✔ | ✔ | ✔ | | |

| 'AES-OCB'⁴ | | | ✔ | | ✔ | | |

| 'Argon2d'⁴ | | | | | ✔ | | |

| 'Argon2i'⁴ | | | | | ✔ | | |

| 'Argon2id'⁴ | | | | | ✔ | | |

| 'ChaCha20-Poly1305'⁴ | | | ✔ | | ✔ | | |

| 'ECDH' | ✔ | ✔ | ✔ | ✔ | | ✔ | |

| 'ECDSA' | ✔ | ✔ | ✔ | ✔ | | ✔ | |

| 'Ed25519' | ✔ | ✔ | ✔ | ✔ | | ✔ | |

| 'Ed448'⁵ | ✔ | ✔ | ✔ | ✔ | | ✔ | |

| 'HDKF' | | | | ✔ | ✔ | | |

| 'HMAC' | | | ✔ | ✔ | ✔ | | |

| 'KMAC128'⁴ | | | ✔ | | ✔ | | |

| 'KMAC256'⁴ | | | ✔ | | ✔ | | |

| 'ML-DSA-44'⁴ | ✔ | ✔ | ✔ | | | ✔ | ✔ |

| 'ML-DSA-65'⁴ | ✔ | ✔ | ✔ | | | ✔ | ✔ |

| 'ML-DSA-87'⁴ | ✔ | ✔ | ✔ | | | ✔ | ✔ |

| 'ML-KEM-512'[^现代算法] | ✔ | ✔ | | | | ✔ | ✔ |

| 'ML-KEM-768'[^现代算法] | ✔ | ✔ | | | | ✔ | ✔ |

| 'ML-KEM-1024'⁴ | ✔ | ✔ | | | | ✔ | ✔ |

| 'PBKDF2' | | | | ✔ | ✔ | | |

| 'RSA-OAEP' | ✔ | ✔ | ✔ | | | | |

| 'RSA-PSS' | ✔ | ✔ | ✔ | | | | |

| 'RSASSA-PKCS1-v1_5' | ✔ | ✔ | ✔ | | | | |

| 'X25519' | ✔ | ✔ | ✔ | ✔ | | ✔ | |

| 'X448'⁵ | ✔ | ✔ | ✔ | ✔ | | ✔ | |