tester-army/e2e

来源：https://github.com/tester-army/e2e

e2e

e2e 是一个面向 Web 和移动端应用的端到端测试框架。用自然语言描述一个目标，让一个 agent 驱动应用去达成它。在同一个测试中用定位器和断言验证结果。

// tests/checkout.e2e.ts
import { test, expect } from 'e2e';

test('a member upgrades to Pro', async ({ app, agent, screen }) => {
  await app.open('/settings/billing');
  await agent.act('upgrade the workspace to the Pro plan');
  await agent.assert('the invoice preview shows a prorated amount');
  await expect(screen.getByRole('status')).toContainText('Pro');
});

如果某个 agent 步骤会被后续的断言所验证，框架会记录它的操作，之后的测试运行会直接重放这些操作，不再调用模型，直到应用发生变化为止。不含 agent 步骤的测试完全不需要模型。

你可以自带订阅、API key 或本地模型。

快速开始

npx e2e init

init 会询问你选择引擎（web 或 mobile）和模型提供方，然后生成一份配置文件和一个示例测试。其余内容请参阅快速开始文档。

软件包

文档

e2e.tester.army/docs。

e2e 软件包会随包发布全部文档页面，因此编码 agent 可以离线阅读 node_modules/e2e/docs 下的内容。

参与贡献

参阅 CONTRIBUTING.md。

如有问题，请前往 Discord。

安全

请勿就安全漏洞提交公开 issue。请遵循 SECURITY.md，并将问题发送至 [email protected]。

遥测

CLI 会发送匿名使用数据，例如运行了哪些命令和引擎、运行在何处失败等，但不会发送任何测试内容、应用内容或凭据。你可以通过 npx e2e telemetry disable 或设置 E2E_TELEMETRY_DISABLED=1 关闭遥测。遥测文档 列出了所有字段。

状态

e2e 正在积极开发中，目标是发布 1.0。API 和配置仍可能在次版本之间发生变化。

由 TesterArmy 打造

e2e 由 TesterArmy 构建，这是一个 agentic 测试平台，可在每次 pull request 或按计划定时，对 Web 和移动端应用运行自然语言测试。

Apache-2.0.