@artilleryio/playwright-reporter

中文文档
1.1.3发布于 2025/02/26SEE LICENSE IN LICENSE.txtTypeScriptESM + CJS近 30 天下载 2.4万

炮兵云剧作家记者

中文使用文档
文档目录12 节
  1. 学多点
  2. 使用量
  3. 安装记者
  4. 启用记者
  5. 设定您的炮兵云 API 密钥
  6. 运行您的剧作家测试
  7. GitHub 动作
  8. 使用Web Vitus进行性能跟踪(实验性)
  9. 截图
  10. 目前的限制
  11. 路线图
  12. 许可证

升级您的 Playwright E2E 测试

Artillery Cloud Playwright Reporter

添加 @artilleryio/playwright-reporter 到您的 Playwright 项目 获取 :

  • 用于 Playwright 测试报告的云仪表板
  • 实时报告截图、痕迹和附件
  • 自动跟踪Web维生性能衡量标准
  • 有痕迹的调试 CI 失败
  • GitHub 动作与 PR 注释集成

开始一个免费的炮兵云帐号 https://app.artillery.io (英语)

学多点

使用量

安装记者

添加 @artilleryio/playwright-reporter 到您的项目作为 dev 依赖:

npm install -D @artilleryio/playwright-reporter

启用记者

启用您 Playwright 配置中的记者( T)playwright.config.ts:

const config: PlaywrightTestConfig = {
  reporter: [
    ['@artilleryio/playwright-reporter', { name: 'My Test Suite' }],
  ],
  // ... rest of your config
};

[注] 从记者的更早版本升级? 这个 blob 记者不再需要使用 @artilleryio/playwright-reporter。您可以在您配置中的记者名单上删除它.

设定您的炮兵云 API 密钥

签入"炮兵云"(免费)并创建API键: https://app.artillery.io/ settings/api-keys 互联网档案馆的存檔,存档日期2014-12-22。 。 。 .

然后导出您的 ARTILLERY_CLOUD_API_KEY数字 :

export ARTILLERY_CLOUD_API_KEY=a9_your_api_key

运行您的剧作家测试

npx playwright test

测试开始后,记者会将测试运行的URL打印到控制台. URL会像这样:

https://app.artillery.io/b9j745e5cx4yrxcrb4qwpfty7p8r3/playwright/pwzxhq_abcdefabcdefghi_7atf

您可以实时在"炮兵云"中跟踪测试运行进度,每次测试都有截图和痕迹.

GitHub 动作

当记者被使用在一个 GitHub Action 工作流程中时,它可以随测试结果向PR发布评论. 要启用 PR 注释, 设置 GITHUB_TOKEN 您运行 Playwright 测试的 GitHub 动作工作中的环境变量 :

jobs:
  test:
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'

      - name: Run Playwright tests
        env:
          ARTILLERY_CLOUD_API_KEY: "${{ secrets.ARTILLERY_CLOUD_API_KEY }}" # API key to send results to Artillery Cloud
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Enable PR comments
        run: npx playwright test

使用Web Vitus进行性能跟踪(实验性)

您可以配置测试以跟踪 网络维度 自动为您测试的每个页面( LCP, CLS, FCP, TTFB, 和INP) .

为了能够进行性能跟踪,请使用 withPerformanceTracking() 扩展 Playwright 内置的方法 test 函数 :

// Rename the "test" import from @playwright/test to "base":
import { test as base } from '@playwright/test';
// Import the withPerformanceTracking function:
import { withPerformanceTracking } from '@artilleryio/playwright-reporter';

// Extend the base test function with performance tracking. This needs to be at the top before using test()
const test = withPerformanceTracking(base);

// The rest of your tests remain the same, e.g.:

test('has title', async ({ page }) => {
  await page.goto('https://playwright.dev/');
  await expect(page).toHaveTitle(/Playwright/);
});

截图

报告概览除错出错
OverviewDebug

目前的限制

  • 以已磨损模式运行的测试尚未得到充分支持 。 每跑一跑都会在"炮兵云"中产生多份部分报告,每分一分. 我们很快会释放出全力支持被压抑的跑道.

路线图

这些是我们正在积极从事的一些工作。 如果你有特别要求或想法,请告诉我们 支持@ artillery.io。 。 。 .

  • 完全支持软化测试运行
  • 更好的 GitHub 动作整合

许可证

炮兵云游剧作家记者根据FSL-1.1-ALv2获得许可 公平来源许可证见 LICENSE.txt (英语) 详细文件.

版本与发布记录

@artilleryio/playwright-reporter 共发布 15 个版本,首次发布于 2024/11/19;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.1.3latest2025/02/261.7 年前
1.1.22025/02/151.7 年前
1.1.12025/02/151.7 年前
1.1.02025/02/151.7 年前
1.0.02024/12/031.9 年前
0.0.102024/12/031.9 年前

关于 @artilleryio/playwright-reporter 的常见问题

@artilleryio/playwright-reporter 是什么?

炮兵云剧作家记者

如何安装 @artilleryio/playwright-reporter?

在项目目录运行 npm install @artilleryio/playwright-reporter,或使用 pnpm add / yarn add / bun add。

@artilleryio/playwright-reporter 支持 TypeScript 吗?

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

@artilleryio/playwright-reporter 支持 ESM 还是 CommonJS?

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

@artilleryio/playwright-reporter 可以商用吗?

@artilleryio/playwright-reporter 使用 SEE LICENSE IN LICENSE.txt 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@artilleryio/playwright-reporter 的下载量有多少?

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

@artilleryio/playwright-reporter 还在维护吗?

最新版本 1.1.3 发布于 2025/02/26(1.7 年前);至今共发布 15 个版本,其中过去 12 个月发布了 0 个;首次发布于 2024/11/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。