Глобальний об’єкт crypto надає getRandomValues(typedArray), randomUUID() і
crypto.subtle — SubtleCrypto на основі тієї самої реалізації AWS-LC, що й
node:crypto. Ключі — це об’єкти CryptoKey (глобальний клас); вони мають
спільний ключовий матеріал із KeyObject, тож KeyObject.from(cryptoKey) і
keyObject.toCryptoKey() перетворюють без копіювання. util.types.isCryptoKey() і
util.types.isKeyObject() їх розпізнають.
| Операція | Алгоритми |
|---|---|
digest | SHA-1, SHA-256, SHA-384, SHA-512, SHA3-256/384/512, cSHAKE128/256 (без імені функції чи кастомізації) |
generateKey, importKey, exportKey | RSASSA-PKCS1-v1_5, RSA-PSS, RSA-OAEP, ECDSA, ECDH (P-256, P-384, P-521), Ed25519, X25519, HMAC, AES-CTR/CBC/GCM/KW, ChaCha20-Poly1305; HKDF і PBKDF2 — лише імпорт |
sign, verify | RSASSA-PKCS1-v1_5, RSA-PSS, ECDSA, Ed25519, HMAC |
encrypt, decrypt | RSA-OAEP, AES-CTR, AES-CBC, AES-GCM, ChaCha20-Poly1305 |
wrapKey, unwrapKey | AES-KW і кожен алгоритм encrypt/decrypt |
deriveBits, deriveKey | ECDH, X25519, HKDF, PBKDF2 |
getPublicKey, SubtleCrypto.supports | як у Node (експериментально) |
Формати ключів: raw (і псевдоніми raw-public/raw-secret), spki, pkcs8 і jwk.
const key = await crypto.subtle.generateKey(
{ name: "AES-GCM", length: 256 },
true,
["encrypt", "decrypt"],
);
const iv = crypto.getRandomValues(new Uint8Array(12));
const sealed = await crypto.subtle.encrypt(
{ name: "AES-GCM", iv },
key,
new TextEncoder().encode("hello"),
);Перевірка, імена помилок і повідомлення відповідають Node. Elide поводиться як збірка на основі
BoringSSL, тож алгоритми, які Node пропонує лише з OpenSSL 3, недоступні: Ed448, X448, AES-OCB, KMAC,
Argon2, ML-DSA, ML-KEM, TurboSHAKE і KangarooTwelve відхиляються з NotSupportedError.
Reference
Status: Full · Not measured · since 1.1.0
Exports
| Export | Kind | Status | Notes |
|---|---|---|---|
crypto | object | Full | randomUUID(), getRandomValues(), subtle |
SubtleCrypto | class | Full | digest(), encrypt(), decrypt(), sign(), verify(), generateKey(), importKey(), exportKey(), deriveBits(), deriveKey(), wrapKey(), unwrapKey() |