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

版本历史

版本	变更
v24.18.0	Added JWK format support for ML-KEM key types.
v24.15.0	Importing ML-DSA and ML-KEM PKCS#8 keys without a seed is no longer supported.
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.

查看关键格式了解当前支持的算法和格式。

🌐 See Key formats for the algorithms and formats currently supported.