@bigbinary/neeto-tags-playwright

中文文档
1.0.3发布于 2026/10/28Apache-2.0TypeScriptES Module零依赖近 30 天下载 4374

Playwright帮手为需要标记纳米.

中文使用文档
文档目录4 节
  1. 使用量
  2. 断开选择器清除
  3. 地方发展
  4. 释放

标签 Playwright 助手

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

使用量

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

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

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

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

"paths": {
  "@neetotags": ["./node_modules/@bigbinary/neeto-tags-playwright"]
}
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-containerV2 Popover使用可选的主机提供测试ID; 内置选择生成 <prefix>-select-input启用 assignTag默认 弹出浏览或通过主机的实际输入ID作为 pickerTestId。 。 。 .

地方发展

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

yarn build && yalc publish
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 共发布 4 个版本,首次发布于 2026/10/16;过去 12 个月发布了 4 个版本。

版本发布日期距今
1.0.3latest2026/10/2810 天前
1.0.22026/10/1623 天前
1.0.12026/10/1623 天前
0.0.0-stage2026/10/1623 天前

关于 @bigbinary/neeto-tags-playwright 的常见问题

@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(10 天前);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2026/10/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。