e2e

项目简介

e2e 是面向 Web 与移动应用的开源端到端测试框架。测试在同一用例中结合自然语言代理操作、精确的定位器和确定性断言。经验证的代理步骤会记录其操作，后续运行在应用未变化时无需调用模型即可重放。

核心功能

• 自然语言目标让 AI 代理驱动应用，同时测试保留确定性定位器和断言；经验证的代理操作会在后续运行中重放，应用未变化时无需调用模型；同一套共享 API 支持 Web 与移动测试；配置可选择 AI 模型、代理系统提示词和执行引擎；不含代理步骤的测试不需要模型；Web 执行通过 Playwright 支持 Chromium、Firefox 和 WebKit，移动执行通过 agent-device 驱动 iOS 模拟器和 Android 模拟器。

适用场景

• 用于 Web 应用和移动应用的端到端测试；对难以用稳定选择器表达的测试步骤使用 AI 代理，同时在需要精确性的地方保留确定性断言；在 CI 中运行测试，未发生变化时重放缓存的代理操作；通过迁移指南从 Playwright、Cypress、Selenium、Detox 或 Maestro 迁移。

快速开始

• 运行 npx e2e init；它会询问 Web 或移动引擎以及模型提供商，然后写入配置和示例测试。文档快速开始介绍其余设置。

部署与要求

• 不含代理步骤的测试不需要模型；模型访问可使用 ChatGPT、GitHub Copilot 或 SuperGrok 订阅，也可使用 Vercel AI Gateway 或 OpenRouter 密钥，或让运行器指向本地服务器；密钥保留在环境变量中，配置引用命名凭据，运行器在运行时填入；CI 模式会自动启用，包含一次重试、只读跟踪缓存，并在未发生变化时无需模型调用即可重放经验证的代理操作。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。