# @app-studio/qa-presets 中文文档

规范地址：https://npmcn.com/package/%40app-studio/qa-presets/

版本：0\.11\.6
npm 元数据更新时间：2026-11-05T23:12:10.136Z
中文译文更新时间：2026-11-08T00:02:36.304Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40app-studio/qa-presets
原文对照：https://npmcn.com/package/%40app-studio/qa-presets/?lang=original

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

- 包体积（解压后）：50 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：1 个
- peer 依赖：vitest \>=3\.2\.6
- 首次发布：2026-08-09T15:45:56.094Z
- 最新版本发布：2026-11-05T23:12:09.963Z
- 近 30 天下载量：1966（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 33 个）

## 中文简介

Vitest 和 Playwright 配置由 qa. bindings.json 所建,加上覆盖和排版检查鼠标,让债务显露出来但从未增长.

## 安装

```sh
npm install @app-studio/qa-presets
```

也可以使用：`pnpm add @app-studio/qa-presets`、`yarn add @app-studio/qa-presets`、`bun add @app-studio/qa-presets`

## README

# `@app-studio/qa-presets`

快速证明设定的默认值 :

-   单位测试时间短而无服务;
-   共享融合世界连续运作;
-   剧作家不重试;
-   Playwright明显是无头的,所以套接字运行不打开桌面窗口;
-   默认 `proof` 配置文件没有录像,只保留故障的痕迹;
-   当套件特定环境重要时,服务器再利用是选入的.

```ts
createPlaywrightConfig({
  bindings,
  testDir: './tests/e2e',
  projects: [{ name: 'scenario', port: 'front' }],
});
```

设定 `profile: 'fast'` (或 `QA_BROWSER_PROFILE=fast`对于没有跑者拥有的媒体, 财务报告和审定财务报表 `profile: 'record'` 用于无头视频,跟踪和截图. 假设 v3 并省略其明确的检查站媒体 `fast`JSON的判决还在进行.

对于一个剧作家主持人, `qa scenario run --engine chromium --video webm` (或 `QA_BROWSER_VIDEO=webm`) 启用视频, 即使快速配置。 剧作家 生成 WebM; MP4 和 GIF 请求明显失败, 而非生成无 记录。 主机必须绑定 `chromium` 给它的 Playwright 方案命令. 视频在上下文关闭后可在Playwright的测试输出中提供.

使用单独的 Playwright 项目来进行未经认证的直接导航 和带有完整浏览器布局的英文副本并点击测试:

```ts
projects: [
  { name: 'anonymous-en', port: 'front', use: {
    browserName: 'chromium', locale: 'en-US',
    storageState: { cookies: [], origins: [] },
  } },
]
```

假设情况下,直接通向受保护的路径,并申明由此产生的 URL和可见的登录内容. 将预期的英文出错文本在 相关动作; 如果应用程序选择独立于浏览器的语言 语言, 也可以在主机中配置选择 。 对于重叠的菜单, 维护最上方的元素,或在重叠的坐标上与之互动 Chromium; 仅凭近似渲染器的截图无法证明击中 测试。 把场景判决记录下来.

要将失败的现有测试归类为已存在的测试, 运行相同的命令 对照候选人的环境及其基准修订单 报到。 报告结果和修订;未修改行数 无法证明失败早于变化.

State Fixture 项目应当使用单独的配置,其中只包含调试工作室服务器.

## 常见问题

### @app-studio/qa-presets 是什么？

Vitest 和 Playwright 配置由 qa\. bindings\.json 所建,加上覆盖和排版检查鼠标,让债务显露出来但从未增长\.

### 如何安装 @app-studio/qa-presets？

在项目目录运行 npm install @app-studio/qa-presets，或使用 pnpm add / yarn add / bun add。

### @app-studio/qa-presets 支持 TypeScript 吗？

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

### @app-studio/qa-presets 支持 ESM 还是 CommonJS？

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

### @app-studio/qa-presets 需要什么版本的 Node\.js？

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

### @app-studio/qa-presets 可以商用吗？

@app-studio/qa-presets 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @app-studio/qa-presets 的下载量有多少？

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

### @app-studio/qa-presets 还在维护吗？

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