@cerios/playwright-expectly-core

中文文档
1.1.1发布于 2026/11/06MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 2627

共享@ cerios/ playwright- expect 包的公用事业 .

中文使用文档
文档目录4 节
  1. 里面的东西
  2. 使用(用于 @cerios/playwright-expectly* 软件包作者)
  3. 链接
  4. 许可证

@ cerios/ playwright- 期望核心

npm version License: MIT

共用内部公用事业 @cerios/playwright-expectly 财务报告和审定财务报表 @cerios/playwright-expectly-fuzzy 软件包.

此软件包并非直接安装或使用. 对方的依赖性 @cerios/playwright-expectly* 软件包并存在,以避免重复它们之间的共享匹配器构建逻辑。 其API可能会改变,而不会严格遵循消费者化软件包.

里面的东西

  • withMatcherState(matchers) ——将一个简单的匹配器功能对象包起来,这样每个匹配器都有打入Playwright的匹配器状态(英语:this.isNot, (中文(简体) ), this.utils内部(等等) expect.extend()- 样式定义,并保持错误堆栈指向用户的呼叫站点.
  • runPolledMatcher(state, options, poll, { target, until, waitFullTimeout }) ——与Playwright的计时共享投票回路 expect.poll(),没有嵌入式报告步骤 expect.poll() 将添加。 当 target 页面或上下文会关闭(就像测试时间结束时那样),投票会立刻停止,而匹配者失败消息会得到一个便条,因此匹配者仍然报告它看到的最后一个值. 与 waitFullTimeout而不是放弃下一时间间隔将超过最后期限.
  • pollLocators(...), (中文(简体) ), locatorNotFoundMessage(...), (中文(简体) ), hasElements(locator), (中文(简体) ), assertLocators(...) ——用Playwright的语义为缺失元素定位投票,共享"元素未找到"失败消息.
  • PollOptions, (中文(简体) ), PolledMatcherOptions, (中文(简体) ), Closeable, (中文(简体) ), MatcherReturnType ——投票匹配者共享类型Script.

使用(用于 @cerios/playwright-expectly* 软件包作者)

import { withMatcherState } from "@cerios/playwright-expectly-core";

export const myMatchers = withMatcherState({
    toBeSomething(actual: unknown) {
        // `this` here is typed with Playwright's ExpectMatcherState
        return { pass: actual === "something", message: () => "..." };
    },
});

许可证

麻省理工学院

版本与发布记录

@cerios/playwright-expectly-core 共发布 7 个版本,首次发布于 2026/06/13;过去 12 个月发布了 7 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.1.1latest2026/11/063 天前
1.1.02026/10/2613 天前
1.0.12026/09/161 个月前
1.0.02026/07/163 个月前
0.1.12026/07/034 个月前
0.1.02026/06/134 个月前

关于 @cerios/playwright-expectly-core 的常见问题

@cerios/playwright-expectly-core 是什么?

共享@ cerios/ playwright- expect 包的公用事业 .

如何安装 @cerios/playwright-expectly-core?

在项目目录运行 npm install @cerios/playwright-expectly-core,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@playwright/test(>=1.40.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cerios/playwright-expectly-core 支持 TypeScript 吗?

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

@cerios/playwright-expectly-core 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cerios/playwright-expectly-core 可以商用吗?

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

@cerios/playwright-expectly-core 的下载量有多少?

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

@cerios/playwright-expectly-core 还在维护吗?

最新版本 1.1.1 发布于 2026/11/06(3 天前);至今共发布 7 个版本,其中过去 12 个月发布了 7 个;首次发布于 2026/06/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。