# @bigbinary/neeto-webhooks-playwright 中文文档

规范地址：https://npmcn.com/package/%40bigbinary/neeto-webhooks-playwright/

版本：1\.0\.3
npm 元数据更新时间：2026-10-28T11:45:41.056Z
中文译文更新时间：2026-11-08T02:22:08.501Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40bigbinary/neeto-webhooks-playwright
原文对照：https://npmcn.com/package/%40bigbinary/neeto-webhooks-playwright/?lang=original
源码仓库：https://github.com/neetozone/neeto-webhooks-nano

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

- 包体积（解压后）：26 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.13
- 运行依赖：0 个
- peer 依赖：@playwright/test 1\.63\.0，@bigbinary/neeto-cist 1\.0\.17，playwright-i18next-fixture 1\.0\.0，@bigbinary/neeto-playwright-commons ^5\.0\.0
- 首次发布：2026-10-15T15:04:01.338Z
- 最新版本发布：2026-10-28T11:45:40.872Z
- 近 30 天下载量：5038（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

Playwright 帮手为需要网络呼声纳米.

## 安装

```sh
npm install @bigbinary/neeto-webhooks-playwright
```

也可以使用：`pnpm add @bigbinary/neeto-webhooks-playwright`、`yarn add @bigbinary/neeto-webhooks-playwright`、`bun add @bigbinary/neeto-webhooks-playwright`

## README

# Webhooks 游戏作家助手

`@bigbinary/neeto-webhooks-playwright` 包含网接POM、选择器和 这个纳米机拥有的类型。 它的版本和出版独立于 `@bigbinary/neeto-webhooks-frontend`。 。 。 .

通名网钩. 站点 API (`WebhookSiteApi`)和常数 (单位:千美元)`DEFAULT_WEBHOOKS_RESPONSE_TEXT`留下来 `@bigbinary/neeto-playwright-commons`· ; `WebhooksPage` 使用常识' `WebhookSiteApi`。 。 。 .

## 使用量

装入消耗品中 `playwright-tests/` 目录 :

```sh
yarn add -D @bigbinary/neeto-webhooks-playwright
```

产品提供列于 `package.json`,包括: `@bigbinary/neeto-playwright-commons`。不需要前端软件包.

和普通人一样,软件包仅是ES模块,而Playwright加载的规格是 常见JS. 在旁边添加路径别名 `@neetoplaywright` 在产品中 `playwright-tests/tsconfig.json`,然后通过它导入.

```json
"paths": {
  "@neetowebhooks": ["./node_modules/@bigbinary/neeto-webhooks-playwright"]
}
```

```ts
import {
  WebhooksApi,
  WebhooksPage,
  WEBHOOK_HEADERS,
  WEBHOOK_SELECTORS,
} from "@neetowebhooks";
```

-   构造 `WebhooksPage` 与 `{ page, neetoPlaywrightUtilities }`和以前一样. 秘密菜单和递送细节 帮助对象针对 `/v2` (原始内容存档于2018-09-21). Sheet UI.
-   `addWebhook({ webhookSiteURL, event })` 使用该标签检查事件,或 第一个列出的事件 `event` 被省略,并保存.
-   `performTableAction(endpoint, "edit" | "delete")` 财务报告和审定财务报表 `performLinkAction("regenerate" | "delete")` 打开一行 webhook 或 秘密 菜单动作.
-   `openMatchingDelivery<Payload>({ matches })` 打开交货直到 `matches(payload, headerText)` 返回真实。 传出产品的有效载荷类型.
-   `verifyHeaders()` 检查 `WEBHOOK_HEADERS` 签名头,和 `verifyResponse()` 检查交付的反应机构.
-   `getTokenViaAPI()` 返回时 `{ webhookToken, webhookSiteURL }`,以及 `verifyLatestWebhookResponse({ webhookToken, callback })` 检查最新的 请求 webhook. 网站收到.
-   `new WebhooksApi(neetoPlaywrightUtilities)` 包裹纳米的REST API: `fetch`, (中文(简体) ), `create({ entityType, entityId, endpoint, events })`, (中文(简体) ), `delete`, (中文(简体) ), `fetchDeliveries`, (中文(简体) ), `showDelivery`,以及 `redeliver(webhookId, deliveryId)`。 。 。 . 送货方法采用网络浏览和送货 **编号** 数值; `delete` 拿着 webhook 的数据库 `id`。 。 。 . `redeliver` 执行员额 `/redeliver` 路线.
-   `getWebhookIdViaRequest({ entityId, endpoint })` 返回匹配 webhook 的数据库编号,或 `undefined` 如果它缺席.
-   `deleteWebhookViaRequest({ entityId, endpoint })` 删除匹配 webhook; 一个缺失的端点是无操作.
-   `deleteWebhookViaUI(endpoint)` 删除当前网页上一行, 证实警报 核实吐司 等待排队消失.
-   `setWebhookEvents(endpoint, events)` 编辑一个网点, 只提供 检查事件标签,保存更改并核实行。 如果这些事件 中,它关闭未修改的工作表.
-   `findDeliveryViaRequest(webhookId, predicate)` 阅读列表中的交货情况 命令并返回第一个 `WebhookDelivery` 谁的解析 `request_body` 满足上游,或 `undefined`它跳过没有尸体的交付 将完整的剖面体通过到上方。 使用返回的内容 `sid` aPI 应用程序 请求 `identifier` 送货的UI链接.
-   `verifyWebhookDeliveries({ callback, ...fields })` 证明成功 交付并传递其解析 `webhook` 载荷呼叫回话.
-   `verifyWebhookDeliveryByEvent({ event, callbackToVerifyDeliveries, ...fields })` 打开事件交付 运行有效载荷核查.
-   宿主的i18next sixture 必须在 POM 之前装入纳米翻译 创建.

包明确输出 `FindWebhookParams`, (中文(简体) ), `WebhookRecord`,以及 `WebhookDelivery` 及其现有参数和召回类型.

## 地方发展

要尝试产品中未释放的更改,请与 `yalc` 从此目录, 然后在产品中添加包装 `playwright-tests/` 目录。 删除 雅尔克链接之前, 执行所以产品显示和锁定文件停留 不变:

```sh
yarn build && yalc publish
```

```sh
cd path/to/product/playwright-tests
yalc add --dev @bigbinary/neeto-webhooks-playwright
```

第一次出版后, `yalc push` 从 `playwright/` 更新每个产品 加上了包裹 以 `yalc remove @bigbinary/neeto-webhooks-playwright`。 。 。 .

## 释放

将 PR 合并到 `playwright` 标签和a `patch`, (中文(简体) ), `minor`,或 `major` 标签. 现有的 NeetoCI 凸起工作流程发布此软件包并打开 `Bump version` 公关.

## 常见问题

### @bigbinary/neeto-webhooks-playwright 是什么？

Playwright 帮手为需要网络呼声纳米\.

### 如何安装 @bigbinary/neeto-webhooks-playwright？

在项目目录运行 npm install @bigbinary/neeto-webhooks-playwright，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@playwright/test（1\.63\.0）、@bigbinary/neeto-cist（1\.0\.17）、playwright-i18next-fixture（1\.0\.0）、@bigbinary/neeto-playwright-commons（^5\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @bigbinary/neeto-webhooks-playwright 支持 TypeScript 吗？

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

### @bigbinary/neeto-webhooks-playwright 支持 ESM 还是 CommonJS？

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

### @bigbinary/neeto-webhooks-playwright 需要什么版本的 Node\.js？

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

### @bigbinary/neeto-webhooks-playwright 可以商用吗？

@bigbinary/neeto-webhooks-playwright 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @bigbinary/neeto-webhooks-playwright 的下载量有多少？

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

### @bigbinary/neeto-webhooks-playwright 还在维护吗？

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