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

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

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

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

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

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

- 包体积（解压后）：27.4 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.13
- 运行依赖：0 个
- peer 依赖：@faker-js/faker 10\.5\.0，@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-16T05:53:11.747Z
- 最新版本发布：2026-10-28T11:45:43.963Z
- 近 30 天下载量：4374（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

Playwright帮手为需要标记纳米.

## 安装

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

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

## README

# 标签 Playwright 助手

`@bigbinary/neeto-tags-playwright` 包含标记 POM, API 帮助器, 选择器, 以及这种纳米机拥有的种类。 它的版本和出版独立于 `@bigbinary/neeto-tags-frontend`。 。 。 .

## 使用量

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

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

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

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

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

```ts
import {
  MERGE_TAGS_SELECTORS,
  TAGS_SELECTORS,
  TagsApi,
  TagsPage,
} from "@neetotags";
```

-   构造 `TagsPage` 与 `(page, neetoPlaywrightUtilities, tagsRequestUrl?)`。 。 。 . 它驱动纳米 `/v2` 仪表板,合并流量,和实体标记取取取器UI. 过 `tagsRequestUrl` 当主机服务于标签 API 时, 地址不在 `${BASE_URL}/admin/tags` (单位:千美元)`/api/v1/admin/tags`),例如: `${BASE_URL}/desk/tags` {\\fn华文仿宋\\fs16\\1cHD1D1D1}在德克岛.
-   `addTagViaUI({ tagName, description, addTagsLabel })`, (中文(简体) ), `fillTagDetails`, (中文(简体) ), `editTagViaUI`, (中文(简体) ), `verifyTag`, (中文(简体) ), `deleteTagViaUI`, (中文(简体) ), `attemptDeleteTagViaUIAndExpectError`, (中文(简体) ), `searchAndVerifyTags`,以及 `filterTagsViaUI` 驱动标记仪表板和表格. `getTagRow(tagName)` 返回匹配的仪表板行定位符.
-   `addTagViaRequest({ name, description, style })` 通过 API 创建标签 并归还它. `deleteTagViaRequest(tagId)` 删除一个. `deleteTagsByNameViaRequest(names)` 从配置的 URL 获取标签和 删除名称与条目完全匹配的每个已返回标签 `names`。 没有名字匹配时什么都不做.
-   `navigateToMergeTagsPage()` 打开合并页面。 打电话之前 `mergeTags({ sourceTags, destinationTag })` 或者说 `mergeAndVerifyTagsViaUI`,则 使用情况 `verifyMergedTags` 检查结果. `searchAndSelect({ selector, tagName, rowSelector })` 搜索并选择一个 合并表单中的源或目的标记.
-   `assignTag({ tagName, pickerTestId, create })` 财务报告和审定财务报表 `removeAssignedTag({ tagName })` 驱动实体 `TagsComponent` 拾取器和 选中的标签徽章 。 默认, `assignTag` 找到 V2 Popover 组合框 以其翻译的搜索占位符。 过 `pickerTestId` 特定东道方 输入,包括内置拾取器.
-   `verifyTagOption(tagName, { visible = true } = {})` 打开 V2 弹出器, 搜索名称,检查匹配选项的能见度,并关闭 拣取者. 使用 `{ visible: false }` 用于缺少或已经指定的标记。 内容 选项类型导出为 `VerifyTagOptionProps`。 。 。 .
-   `new TagsApi(neetoPlaywrightUtilities, tagsRequestUrl?)` 覆盖纳米的倒置 结束点 : `fetch(params)`, (中文(简体) ), `create({ name, description, style })`, (中文(简体) ), `update({ id, ... })`, (中文(简体) ), `delete(id)`,以及 `merge({ primaryId, secondaryId })`。 。 。 .
-   宿主的i18next sixture 必须在 POM 之前装入纳米翻译 创建.

## 断开选择器清除

以下内容: `TAGS_SELECTORS` 由于 V2 不渲染 他们:

-   `deleteTagButton` 财务报告和审定财务报表 `tagContainer`: 使用 `COMMON_SELECTORS.badgeCloseButton` 财务报告和审定财务报表 `COMMON_SELECTORS.badgeContainer` 为V2徽章.
-   `metaDataBlock`, (中文(简体) ), `tagItemsCountButton`,以及 `metaDataCard`:只有V1的身份证.
-   `tagSearchField`: 纳米或需要原子产生 `select-tag-container`V2 Popover使用可选的主机提供测试ID; 内置选择生成 `<prefix>-select-input`启用 `assignTag`默认 弹出浏览或通过主机的实际输入ID作为 `pickerTestId`。 。 。 .

## 地方发展

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

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

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

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

## 释放

添加 `playwright` 并且就是其中一个 `patch`, (中文(简体) ), `minor`,或 `major`,然后添加 `release` 最后输入根所描述的 NeetoTower 释放门 读取。 删除公共选择器需要 `minor`。在门合并后 PR, NeetoCI 凸起工作流程发布此软件包并打开 `Bump version` 公关.

## 常见问题

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

Playwright帮手为需要标记纳米\.

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

在项目目录运行 npm install @bigbinary/neeto-tags-playwright，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@faker-js/faker（10\.5\.0）、@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-tags-playwright 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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

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

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