# @arcjet/stable-hash 中文文档 规范地址：https://npmcn.com/package/%40arcjet/stable-hash/ 版本：1\.15\.0 npm 元数据更新时间：2026-10-28T18:46:16.761Z 中文译文更新时间：2026-11-06T14:44:24.039Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40arcjet/stable-hash 原文对照：https://npmcn.com/package/%40arcjet/stable-hash/?lang=original 项目主页：https://arcjet.com/ 源码仓库：https://github.com/arcjet/arcjet-js ## 关键信息（来自 npm 元数据） - 包体积（解压后）：25.1 kB，11 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22\.21\.0 \<23 \|\| \>=24\.5\.0 - 运行依赖：0 个 - 首次发布：2025-05-06T20:57:19.181Z - 最新版本发布：2026-10-28T18:46:12.968Z - 近 30 天下载量：328218（2026-10-07 至 2026-11-05，npm 官方下载统计） - 已发布版本数：38（近 12 个月 30 个） ## 中文简介 Arcjet 稳定散列工具 ## 安装 ```sh npm install @arcjet/stable-hash ``` 也可以使用：`pnpm add @arcjet/stable-hash`、`yarn add @arcjet/stable-hash`、`bun add @arcjet/stable-hash` ## README [![Arcjet Logo](https://arcjet.com/logo/arcjet-light-lockup-voyage-horizontal.svg)](https://arcjet.com/) # `@arcjet/stable-hash` [![npm badge](https://img.shields.io/npm/v/%40arcjet%2Fstable-hash?style=flat-square&label=%E2%9C%A6Aj&labelColor=ECE6F0&color=ECE6F0)](https://www.npmjs.com/package/@arcjet/stable-hash) [弧喷](https://arcjet.com/) 稳定的散列功能. - [npm 软件包 (`@arcjet/stable-hash`(中文(简体) )](https://www.npmjs.com/package/@arcjet/stable-hash) - [GitHub 源代码 (`stable-hash/` 内 `arcjet/arcjet-js`(中文(简体) )](https://github.com/arcjet/arcjet-js/tree/main/stable-hash) ## 这是什么? 这是帮助我们创造稳定散列的内部用途. 并符合其他语言的相似内部代码. 这样做是为了确保各种语言之间的工作相同. ## 我什么时候用这个? 这是内部的Arcjet包件,不为公众使用而设计. 看我们的 [_开始吧_ 指南](https://docs.arcjet.com/get-started) 如何使用Arcjet 在您的 应用. ## 安装 这套方案只是无害环境管理. 在 Node.js 用 npm 安装 : ```sh npm install @arcjet/stable-hash ``` ## 使用 ```ts import * as hasher from "@arcjet/stable-hash"; const id = await hasher.hash( hasher.string("type", "EMAIL"), hasher.uint32("version", 0), hasher.string("mode", "LIVE"), hasher.stringSliceOrdered("allow", []), hasher.stringSliceOrdered("deny", []), ); console.log(id); // => 49573b7df8d854c2cd5d8a755a4c03aff4014493a41b963490861a279ad675b2 ``` ## API 密码 此软件包导出标识符 [`bool`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-boolkey-value), (中文(简体) ), [`hash`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-hashhashers), (中文(简体) ), [`makeHasher`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-makehashersubtle), (中文(简体) ), [`stringSliceOrdered`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-stringsliceorderedkey-value), (中文(简体) ), [`string`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-stringkey-value),以及 [`uint32`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-uint32key-value)。 。 。 . 没有默认导出 . 此套件导出 [类型脚本](https://www.typescriptlang.org/) 类型 [`FieldHasher`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-fieldhasher) 财务报告和审定财务报表 [`StringWriter`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-stringwriter)。 。 。 . ### `FieldHasher` 此类型代表一个单字段的函数. 你得到一个 这些从 `bool`, (中文(简体) ), `string`, (中文(简体) ), `stringSliceOrdered`,以及 `uint32`。 。 。 . ###### 类型 ```ts type FieldHasher = (data: StringWriter) => void; ``` ### `StringWriter` 这种类型代表着一个被收藏者写入数据的写作者. ###### 字段 - `writeString(data: string): void` 将数据写入散列 ### `bool(key, value)` 为布尔值创建字段散列. ###### 参数 - `key` (单位:千美元)`string`(中文(简体) ) ——字段名称 - `value` (单位:千美元)`boolean`(中文(简体) ) 散列的布尔值 ###### 回返 字段缓存( A)[`FieldHasher`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-fieldhasher)) (中文(简体) ). ### `hash(…hashers)` Hashes 多个字段一起返回稳定的散列弦. 你通过 田间散居者 `bool`, (中文(简体) ), `string`, (中文(简体) ), `stringSliceOrdered`,以及 `uint32`。 。 。 . ###### 参数 - `hashers` (单位:千美元)[`Array`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-fieldhasher)(中文(简体) ) ——田地有结合 ###### 回返 A 类 `Promise` 决断于散列`Promise`) (中文(简体) ). ### `makeHasher(subtle)` 使用提供的内容创建新散列函数 `SubtleCrypto` 执行。 我们内部用这个支持不同的密码 跨运行时间的执行. ###### 参数 - `subtle` (单位:千美元)`SubtleCryptoLike`(中文(简体) ) a 包括: `SubtleCrypto`\- 像执行 ###### 回返 散列函数( A)[`hash`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-hashhashers)) (中文(简体) ). ### `stringSliceOrdered(key, values)` 为命令的字符串创建字段散列. ###### 参数 - `key` (单位:千美元)`string`(中文(简体) ) ——字段名称 - `values` (单位:千美元)`ReadonlyArray`(中文(简体) ) ——散列的字符串数组 ###### 回返 字段缓存( A)[`FieldHasher`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-fieldhasher)) (中文(简体) ). ### `string(key, value)` 为字符串值创建字段散列. ###### 参数 - `key` (单位:千美元)`string`(中文(简体) ) ——字段名称 - `value` (单位:千美元)`string`(中文(简体) ) ——散列的字符串值 ###### 回返 字段缓存( A)[`FieldHasher`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-fieldhasher)) (中文(简体) ). ### `uint32(key, value)` 为无符号的32位整数创建字段散列. ###### 参数 - `key` (单位:千美元)`string`(中文(简体) ) ——字段名称 - `value` (单位:千美元)`number`(中文(简体) ) - 散列的整数值 ###### 回返 字段缓存( A)[`FieldHasher`](https://npmcn.com/package/%40arcjet/stable-hash/#readme-fieldhasher)) (中文(简体) ). ## 许可证 [Apache 许可证,2.0版本](http://www.apache.org/licenses/LICENSE-2.0) © [Arcjet实验室股份有限公司.](https://arcjet.com/) 基于 [`feross/buffer`](https://github.com/feross/buffer/tree/5857e295f4d37e3ad02c3abcbf7e8e5ef51f3be6) 特许使用 [麻省理工学院](https://github.com/feross/buffer/blob/5857e295f4d37e3ad02c3abcbf7e8e5ef51f3be6/LICENSE) Feross Aboukhadijeh和撰稿人. 我们的工作选择了它内部的六分编码逻辑 适应我们的使用. ## 常见问题 ### @arcjet/stable-hash 是什么？ Arcjet 稳定散列工具 ### 如何安装 @arcjet/stable-hash？ 在项目目录运行 npm install @arcjet/stable-hash，或使用 pnpm add / yarn add / bun add。 ### @arcjet/stable-hash 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @arcjet/stable-hash 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @arcjet/stable-hash 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.21\.0 \<23 \|\| \>=24\.5\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @arcjet/stable-hash 可以商用吗？ @arcjet/stable-hash 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @arcjet/stable-hash 的下载量有多少？ 根据 npm 官方下载统计，@arcjet/stable-hash 在 2026/10/07 – 2026/11/05 这 30 天内被下载 328,218 次，日均约 10,941 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @arcjet/stable-hash 还在维护吗？ 最新版本 1\.15\.0 发布于 2026/10/29（8 天前）；至今共发布 38 个版本，其中过去 12 个月发布了 30 个；首次发布于 2025/05/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。