Web Crypto API 参考

Web Crypto API 提供浏览器内置的密码学能力，例如安全随机数、UUID、哈希摘要、签名、加密和密钥处理。常见开发场景里，最容易直接用到的是 crypto.randomUUID() 和 crypto.subtle.digest()。

常用能力

生成 UUID

const id = crypto.randomUUID();
console.log(id);

randomUUID() 适合生成请求 ID、测试数据 ID、本地临时标识。它不是登录令牌或 API Key 的完整设计方案，安全凭证还需要过期时间、存储策略和服务端校验。

计算 SHA-256 哈希

async function sha256(text) {
  const bytes = new TextEncoder().encode(text);
  const buffer = await crypto.subtle.digest("SHA-256", bytes);
  return Array.from(new Uint8Array(buffer), (byte) =>
    byte.toString(16).padStart(2, "0")
  ).join("");
}

console.log(await sha256("caijiao.org"));

digest 支持的算法

常见错误

• Web Crypto 多数能力只在 HTTPS 等安全上下文中可用；本地开发的 localhost 通常可以使用。
• crypto.subtle.digest() 不能流式处理超大文件，必须先把输入读入内存。
• 哈希不是加密，不能从哈希值还原原文。
• SHA-1 已不适合安全场景；新代码优先使用 SHA-256 或更高版本。
• 需要 HMAC 时不要只拼接字符串再哈希，应使用 crypto.subtle.sign() 搭配 HMAC 密钥。

相关内容

• Web API Reference
• Blob 参考
• Hash Generator
• UUID Generator
• 浏览器如何生成 UUID
• MDN Web Crypto API
• MDN SubtleCrypto.digest
• MDN Crypto.randomUUID