# @cerios/playwright-expectly-core 中文文档

规范地址：https://npmcn.com/package/%40cerios/playwright-expectly-core/

版本：1\.1\.1
npm 元数据更新时间：2026-11-06T11:17:48.780Z
中文译文更新时间：2026-11-09T13:10:06.077Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40cerios/playwright-expectly-core
原文对照：https://npmcn.com/package/%40cerios/playwright-expectly-core/?lang=original
项目主页：https://github.com/CeriosTesting/playwright-expectly#readme
源码仓库：https://github.com/CeriosTesting/playwright-expectly

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

- 包体积（解压后）：81.2 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@playwright/test \>=1\.40\.0
- 首次发布：2026-06-12T20:09:04.939Z
- 最新版本发布：2026-11-06T11:17:48.415Z
- 近 30 天下载量：2627（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

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

## 安装

```sh
npm install @cerios/playwright-expectly-core
```

也可以使用：`pnpm add @cerios/playwright-expectly-core`、`yarn add @cerios/playwright-expectly-core`、`bun add @cerios/playwright-expectly-core`

## README

# @ cerios/ playwright- 期望核心

[![npm version](https://badge.fury.io/js/%40cerios%2Fplaywright-expectly-core.svg)](https://www.npmjs.com/package/@cerios/playwright-expectly-core) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

共用内部公用事业 [`@cerios/playwright-expectly`](https://www.npmjs.com/package/@cerios/playwright-expectly) 财务报告和审定财务报表 [`@cerios/playwright-expectly-fuzzy`](https://www.npmjs.com/package/@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*` 软件包作者)

```typescript
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: () => "..." };
    },
});
```

## 链接

-   [完整项目 README](https://github.com/CeriosTesting/playwright-expectly#readme)
-   [更改日志](https://npmcn.com/package/%40cerios/playwright-expectly-core/CHANGELOG.md)
-   [问题](https://github.com/CeriosTesting/playwright-expectly/issues)

## 许可证

麻省理工学院

## 常见问题

### @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 和提交记录判断。