# @crvouga/mockingbird-service-recaptcha 中文文档

规范地址：https://npmcn.com/package/%40crvouga/mockingbird-service-recaptcha/

版本：1\.11\.0
npm 元数据更新时间：2026-11-11T02:32:19.694Z
中文译文更新时间：2026-11-11T09:03:06.338Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40crvouga/mockingbird-service-recaptcha
原文对照：https://npmcn.com/package/%40crvouga/mockingbird-service-recaptcha/?lang=original
项目主页：https://github.com/crvouga/mockingbird/tree/main/packages/service/recaptcha#readme
源码仓库：https://github.com/crvouga/mockingbird

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

- 包体积（解压后）：4.2 MB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-10-05T09:27:59.592Z
- 最新版本发布：2026-11-11T02:32:19.316Z
- 近 30 天下载量：2557（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

决定性 reCAPTCHA v3 浏览器 shim和单用 Siteverify模拟器.

## 安装

```sh
npm install @crvouga/mockingbird-service-recaptcha
```

也可以使用：`pnpm add @crvouga/mockingbird-service-recaptcha`、`yarn add @crvouga/mockingbird-service-recaptcha`、`bun add @crvouga/mockingbird-service-recaptcha`

## README

# @crvouga/mockingbird-service-recaptcha (英语)

> 本地模拟器。 真正的API合同. 部分 [嘲笑鸟](https://github.com/crvouga/mockingbird)。 。 。 .

WIP reCAPTCHA v3 模拟器:浏览器 `grecaptcha.ready`编号 :`execute`确定性的单一用途标志, 和形而上学。 合同跟Google一样 [核查](https://developers.google.com/recaptcha/docs/verify) 财务报告和审定财务报表 [页:1](https://developers.google.com/recaptcha/docs/v3) 参考文献。 它不与谷歌联系.

## 安装

```sh
bun add @crvouga/mockingbird-service-recaptcha
```

## 使用量

```ts
import { createServer } from "@crvouga/mockingbird-service-recaptcha/server"

// Test setup: a local reCAPTCHA, and a token like the one grecaptcha.execute hands the browser.
const server = await createServer()
const issued = await fetch(`${server.url}/__admin/issue`, {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ siteKey: "mock_site", action: "login", hostname: "app.example" }),
})
const { token } = await issued.json()

// Application code: the Siteverify call it makes to Google, sent to the emulator's URL.
const siteverifyUrl = `${server.url}/recaptcha/api/siteverify`
const verified = await fetch(siteverifyUrl, {
  method: "POST",
  body: new URLSearchParams({ secret: "mock_secret", response: token }),
})
const { success, score, action } = await verified.json()

await server.close()
```

`mockingbird-recaptcha serve` 单独运行同一服务器; `createRuntime` 从主窗口 条目是进程内表单. 覆盖浏览器脚本 URL `/recaptcha/api.js?render=mock_site` 和服务器 校验 URL 为 `/recaptcha/api/siteverify` 当地出身。 浏览器 shim 使用当地 `/__admin/issue` 请求获取令牌; 管理密钥保护的运行时间 要求由测试带提供标志。 脚本中没有嵌入管理密钥 .

Tokens绑定一个站点密钥,主机名,动作,分数,以及发行时间. 核查消耗量 一次,两分钟后失效 低分还是成功的卖家 校验:应用程序检查其分数阈值、预期动作和主机名.

`PUT /__admin/settings` 接受 `sites`, (中文(简体) ), `score`每起行动 `scores`,回应 `action`编号 : `hostname` 覆盖, `executeError`, (中文(简体) ), `expired`, (中文(简体) ), `replayed`,以及 `errorCodes`。 。 。 . `GET /__admin/attempts` 只返回时间/结果/错误元数据,没有符号或秘密. 共享管理员路由提供时钟控制,重置,时光线历史,命名空间,和断层. 命名空间选择用途 `x-mockingbird-namespace` 或者说 `/__admin/ns/<name>/…`。 。 。 . 自定义 `adminPrefix` 转移发行地点 和shim的本地目标.

预设 : `human`, (中文(简体) ), `bot`, (中文(简体) ), `threshold_boundary`, (中文(简体) ), `expired`, (中文(简体) ), `replayed`, (中文(简体) ), `script_failure`, (中文(简体) ), `rate_limited`,以及 `server_error`。通过 `count: 1` 为一发失败。 通用断层 还支持确定性延迟和连接下降。 不存在网签或页签 在这个卖家表面.

## API 密码

主要出口 `RecaptchaAPI`, (中文(简体) ), `RecaptchaState`, (中文(简体) ), `createRuntime`, (中文(简体) ), `RECAPTCHA_NAMESPACE`, (中文(简体) ), `RECAPTCHA_PRESETS`, (中文(简体) ), `DEFAULT_SETTINGS`, (中文(简体) ), `document`, (中文(简体) ), `operationIds`,以及 `supportedOperationIds`,加上公共类型. 这个 `/server` 进口 `createServer`, (中文(简体) ), `serveTarget`,以及 `DEFAULT_PORT`。 。 。 .

## 故意不模拟

-   Google的风险模型,设备指纹,交互式v2挑战,或称企业API.
-   私人Geviti客户端执行:接受使用有文件记载的Google流量.
-   迎接成功的挑战。 冷平指令探测器只缺少响应 和2号出入口没有 `RECAPTCHA_SECRET_KEY`;绝不在固定装置中使用生产证书.

## 常见问题

### @crvouga/mockingbird-service-recaptcha 是什么？

决定性 reCAPTCHA v3 浏览器 shim和单用 Siteverify模拟器\.

### 如何安装 @crvouga/mockingbird-service-recaptcha？

在项目目录运行 npm install @crvouga/mockingbird-service-recaptcha，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mockingbird-recaptcha，可以用 npx mockingbird-recaptcha 直接运行。

### @crvouga/mockingbird-service-recaptcha 支持 TypeScript 吗？

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

### @crvouga/mockingbird-service-recaptcha 支持 ESM 还是 CommonJS？

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

### @crvouga/mockingbird-service-recaptcha 可以商用吗？

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

### @crvouga/mockingbird-service-recaptcha 的下载量有多少？

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

### @crvouga/mockingbird-service-recaptcha 还在维护吗？

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