Deno中使用Web Crypto API进行字符串SHA-256哈希教程-js教程-PHP中文网

Deno中使用Web Crypto API进行字符串SHA-256哈希教程

花韻仙語

发布： 2025-10-27 09:43:34

原创

791人浏览过

Deno中使用Web Crypto API进行字符串SHA-256哈希教程

本教程详细介绍了如何在deno环境中利用web crypto api对字符串执行sha-256哈希操作。文章将逐步讲解从字符串编码、数据摘要到最终十六进制表示的完整过程，并提供可直接运行的代码示例，帮助开发者高效、准确地实现字符串哈希功能。

Deno中字符串SHA-256哈希实现

在Deno中进行加密操作，包括字符串哈希，主要依赖于其内置的Web Crypto API。这意味着在浏览器环境中实现加密功能的方式，同样适用于Deno。这种跨平台的兼容性为开发者提供了极大的便利。本文将以SHA-256算法为例，演示如何将一个字符串哈希为十六进制格式的输出。

核心原理与步骤

要实现字符串的SHA-256哈希，我们需要遵循以下几个关键步骤：

字符串编码: 首先，将输入的字符串编码成字节数组（Uint8Array）。这是因为加密API通常处理二进制数据而非直接的字符串。
数据摘要: 使用Web Crypto API的crypto.subtle.digest方法对编码后的字节数组进行哈希计算。此方法是异步的，会返回一个包含哈希结果的ArrayBuffer。
结果转换: 将ArrayBuffer形式的哈希结果转换为Uint8Array，以便逐字节处理。
十六进制表示: 最后，将Uint8Array中的每个字节转换为两位十六进制字符串，并拼接起来，形成最终的十六进制哈希值。

示例代码

以下是一个完整的Deno函数，用于实现字符串的SHA-256哈希：

行者AI

行者AI绘图创作，唤醒新的灵感，创造更多可能

100

查看详情

/**
 * 使用SHA-256算法哈希给定的消息字符串。
 *
 * @param message 要哈希的字符串。
 * @returns 一个Promise，解析为消息的十六进制SHA-256哈希值。
 */
async function hash(message: string): Promise<string> {
  // 1. 将字符串编码为UTF-8字节数组
  const data = new TextEncoder().encode(message);

  // 2. 使用SHA-256算法计算数据的哈希摘要
  const hashBuffer = await crypto.subtle.digest('SHA-256', data);

  // 3. 将ArrayBuffer转换为Uint8Array
  const hashArray = Array.from(new Uint8Array(hashBuffer));

  // 4. 将Uint8Array中的每个字节转换为两位十六进制字符串并拼接
  const hashHex = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');

  return hashHex;
}

// 示例用法：哈希字符串 "hello world"
hash('hello world').then(console.log); // 预期输出: b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9

登录后复制

代码详解

new TextEncoder().encode(message): TextEncoder 是一个Web API，用于将字符串编码为特定编码（默认为UTF-8）的Uint8Array。这是进行加密操作前必不可少的一步。
crypto.subtle.digest('SHA-256', data): crypto.subtle 接口提供了低级别的加密原语，如哈希、签名和加密。digest 方法用于计算数据的哈希摘要。第一个参数指定哈希算法（此处为'SHA-256'），第二个参数是待哈希的数据（ArrayBuffer或TypedArray）。由于哈希计算是计算密集型操作，它返回一个Promise。
Array.from(new Uint8Array(hashBuffer)): crypto.subtle.digest 返回一个ArrayBuffer，它是一个通用的、固定长度的原始二进制数据缓冲区。为了方便地访问每个字节，我们将其转换为Uint8Array（一个8位无符号整数数组），然后通过Array.from将其转换为标准的JavaScript数组，便于后续的map操作。
map((b) => b.toString(16).padStart(2, '0')).join(''):
- b.toString(16) 将每个字节（0-255）转换为其十六进制字符串表示。
- padStart(2, '0') 确保每个十六进制值都由两位组成。例如，10（十进制）会变成a，但我们需要0a。255（十进制）会变成ff。
- join('') 将所有两位十六进制字符串连接成一个完整的哈希字符串。

注意事项

异步操作: crypto.subtle.digest 是一个异步函数，因此在调用它时必须使用await关键字，并且包含它的函数必须标记为async。
Deno权限: 在Deno中运行此代码通常不需要特定的文件系统或网络权限，因为crypto API是内置的。
安全性: SHA-256是一种密码学哈希函数，适用于数据完整性校验、数字签名等场景。但请注意，对于密码存储等需要更高安全性的场景，不应直接使用SHA-256哈希。应结合盐值（salt）和密钥派生函数（如PBKDF2、Bcrypt、Scrypt）来增加安全性，以抵御彩虹表攻击和暴力破解。
兼容性: 由于Deno采用了Web Crypto API，这段代码在支持该API的现代浏览器环境中也应该能够直接运行，只需调整模块导入方式（如果需要）。