# @bigbinary/neeto-api-keys-playwright 中文文档

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

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

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

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

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

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

## 中文简介

Playwright helpers for the neeto API key 纳米. 游戏中,游戏的玩家为需要API键纳米.

## 安装

```sh
npm install @bigbinary/neeto-api-keys-playwright
```

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

## README

# API 密钥 Playwright 助手

`@bigbinary/neeto-api-keys-playwright` 包含 API- key POMs, API 帮助器, 选取器 以及这纳米机拥有的种类 已编辑出版 独立 `@bigbinary/neeto-api-keys-frontend`。 。 。 .

## 使用量

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

```sh
yarn add -D @bigbinary/neeto-api-keys-playwright
```

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

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

```json
"paths": {
  "@neetoapikeys": ["./node_modules/@bigbinary/neeto-api-keys-playwright"]
}
```

```ts
import { ApiKeysApi, ApiKeysPage, API_KEYS_SELECTORS } from "@neetoapikeys";
```

-   `ApiKeysPage` 驱动前端 `/v2` 进入点。 它需要剧作家 `page` 和公用设施固定, 像以前一样。 没有帮手 遗产(non-v2) UI.
-   `ApiKeysApi.create(label, type)` 默认为普通密钥并接受 `"zapier"` 作为第二个论点.
-   宿主的i18next sixture 必须在 POM 之前装入纳米翻译 创建.
-   `expiryDate` 实值 `DD/MM/YYYY`选择它 **无过期**,因为 UI否则默认为30天.

## 公共援助人员

`ApiKeysApi` 带 `Pick<CustomCommands, "apiRequest">` 并规定:

-   `fetch(searchTerm, params = {})`: 获取匹配标签的密钥。 额外查询 参数使用蛇 case; 通过 `zapier_integrable_type: "Organization"` 改为 包括整合时的组织 Zapier 键.
-   `create(label, type = "general")`: 创建非过期将军或 Zapier 键.
-   `delete(id, type = "general")`: 删除密钥。 递回来 `type` 这么说 控制器选择正确的常规或Zapier记录.

`ApiKeysPage` 规定:

-   `getApiTokenViaRequest(label)`:返回第一个匹配密钥的符号.
-   `createApiKeyViaRequest(label, type = "general")`: 创建密钥并返回其 符号 .
-   `deleteApiKeyViaRequest(label)`: 删除每个返回的匹配, 转发每个匹配 键的类型。 空结果为无相.
-   `fillApiKeyDetails({ label, expiryDate? })`: 填写并保存打开的密钥工作表.
-   `verifyApiKey({ targetRow, label, date })`: 验证一个未过期的有效密钥 排队.
-   `editApiKey({ label, expiryDate? })`: 从打开行菜单中选择编辑 保存关键细节.
-   `deleteApiKey(targetRow)`:通过行菜单和确认删除密钥.

基于请求的页面帮助器包括组织 Zapier 键可用时, 匹配纳米UI的默认范围. 搜索使用控制器的标签 子字符串匹配; 在获取一个符号时使用一个唯一的标签 .

`API_KEYS_SELECTORS` 输出纳米的UI测试ID。 导出类型为 `ApiKey` (请求帮助者使用的id、标志和类型), `ApiKeyType`, (中文(简体) ), `ApiKeyDetails`,以及 `VerifyApiKeyProps`。 。 。 .

## 地方发展

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

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

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

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

## 释放

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

## 常见问题

### @bigbinary/neeto-api-keys-playwright 是什么？

Playwright helpers for the neeto API key 纳米\. 游戏中,游戏的玩家为需要API键纳米\.

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

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

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

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

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

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

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

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

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

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

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

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

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

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