# @echoscan/browser-verifier 中文文档

规范地址：https://npmcn.com/package/%40echoscan/browser-verifier/

版本：3\.0\.5
npm 元数据更新时间：2026-11-06T16:34:44.860Z
中文译文更新时间：2026-11-14T10:38:12.495Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40echoscan/browser-verifier
原文对照：https://npmcn.com/package/%40echoscan/browser-verifier/?lang=original
项目主页：https://echoscan.org/
源码仓库：https://github.com/ozzxzzo/EchoScan

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：814 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0 \<23
- 运行依赖：0 个
- 首次发布：2026-03-14T03:38:31.227Z
- 最新版本发布：2026-11-06T16:34:44.659Z
- 近 30 天下载量：2071（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

EchoScan预登录设备信任和浏览器指纹的浏览器-侧验证器.

## 安装

```sh
npm install @echoscan/browser-verifier
```

也可以使用：`pnpm add @echoscan/browser-verifier`、`yarn add @echoscan/browser-verifier`、`bun add @echoscan/browser-verifier`

## README

# EchoScan 浏览器验证器

EchoScan 浏览器 校验器在浏览器中运行, 支持预登录设备信任和浏览器 指纹 它使用可发布浏览器 Environment ID 返回服务器发行的 `imprint`· ; 您信任的后端然后查询 EchoScan 报告 API v1 并应用您的商业政策 .

## 设备身份兼容性

2.x和3.x版本使用相同的设备身份命名空间并需要兼容的服务 支持 v4 提交 API 。 现有历史尚存 2.0不自动识别或合并到这个命名空间.

如果设备识别不可用, 运行失败而不提交印记 。 这个技术 失败不能确定风险.

## SDK 3.0 诊断边界

3.0版本删除 `getLastRunTrace()` 已公布的 2.x、, 与先前的详细诊断和错误导出. `run()` 返回时 `imprint` 和可选最小值 `diagnostic` 收据; `SDK_VERSION` 识别已安装的 SDK. 失败使用 `EchoScanError.category`: 取消、 超时、 处理、 运行 in progress, 检测失败,配置或提交失败。 失败者还包括SDK版本和最低限度诊断收据: `not_sent` (无相关API请求), `unconfirmed` (未收到同意),或 `received` (观察到可持久服务器接收),及其API操作. 身份证从不提供诊断。 原始错误,反应机构, 原因、确切期限和内部身份失效原因不是公共合同. 迁移前删除痕量输出和旧错误类检查 。 匹配后端必须部署 先说 对于支持,提供SDK版本,公用出错类别和最小诊断收据. 这些支持细节不能取代正式报告或确定风险.

## 安装

```sh
npm install @echoscan/browser-verifier@3.0.5
```

在 EchoScan 中创建浏览器环境, 将精确的允许来源注册到校验者会在哪里 运行,并复制其可出版 `environmentId`。环境标识不是一个密钥 API 或 工作区身份证.

## 生成印记

```js
import { createEchoScan } from '@echoscan/browser-verifier'

const verifier = createEchoScan({
  environmentId: 'env_0123456789abcdef0123456789abcdef',
})

const { imprint } = await verifier.run()
```

成功运行返回 `imprint` 并且可能包括最低限度的诊断收据。 新印记使用 `imp_<32 lowercase hex>` 格式。 发送 标记到您信任的后端,并有受保护的登录、注册、付款或其他 业务请求.

您的后端使用它唯一的服务器密钥 API 查询报告 API v1:

```http
GET https://api.echoscan.org/api/v1/fingerprint/report/{imprint}
X-API-Key: <server-secret-api-key>
Accept: application/json
```

永远不要在浏览器代码中放置密钥或工作空间ID. 保持完整的报告和最后允许, 对您的后端提出质疑、审查或拒绝决定.

## 无害环境管理、UMD和CDN

Npm 软件包提供无害环境管理、 TypeScript 声明和一个单文件的 UMD 构建, 以曝光方式显示 `window.EchoScan`. 在自主办无害环境管理建设时,公布其匹配情况 `chunks/` 目录也一样. EchoScan还为当前支持的CDN构建服务于:

-   无害环境管理: `https://cdn.echoscan.org/v1/echoscan.esm.js`
-   UMD: (英语) `https://cdn.echoscan.org/v1/echoscan.umd.js`

## 文档

-   [开发者 API 和集成指南](https://echoscan.org/pages/developers/api-en-US.html)
-   [OpenAPI 合同](https://echoscan.org/openapi.json)
-   [EchoScan 平台概览](https://echoscan.org/pages/platform-en-US.html)
-   [公共扫描](https://echoscan.org/scan.html) ——第一党产品示范,不是 替换客户浏览器环境或可信后端集成.

## 常见问题

### @echoscan/browser-verifier 是什么？

EchoScan预登录设备信任和浏览器指纹的浏览器-侧验证器\.

### 如何安装 @echoscan/browser-verifier？

在项目目录运行 npm install @echoscan/browser-verifier，或使用 pnpm add / yarn add / bun add。

### @echoscan/browser-verifier 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @echoscan/browser-verifier 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @echoscan/browser-verifier 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.12\.0 \<23。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @echoscan/browser-verifier 可以商用吗？

@echoscan/browser-verifier 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @echoscan/browser-verifier 的下载量有多少？

根据 npm 官方下载统计，@echoscan/browser-verifier 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,071 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @echoscan/browser-verifier 还在维护吗？

最新版本 3\.0\.5 发布于 2026/11/07（7 天前）；至今共发布 25 个版本，其中过去 12 个月发布了 25 个；首次发布于 2026/03/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。