零成本开始e2e测试：不配模型也能跑的e2e测试框架完整指南

零成本开始e2e测试不配模型也能跑的e2e测试框架完整指南【免费下载链接】e2eNext generation e2e testing framework for web and mobile apps.项目地址: https://gitcode.com/GitHub_Trending/e2e6/e2ee2e是一个面向 Web 和移动端应用的新一代端到端测试e2e testing框架。它最特别的一点是不配置任何 AI 模型也能完整跑通纯确定性的 e2e 测试——不需要 API Key、不需要订阅、零成本就能把端到端测试跑起来。对于刚接触 e2e 测试的新手来说这是最平滑的入门路径。为什么先跑“无模型”的 e2e 测试很多人对 e2e 测试的第一印象是“必须接 AI 才能用”。其实恰恰相反确定性测试是地基用定位器locator 断言expect写出的步骤每一步都精确可控不依赖模型运行结果 100% 可复现。AI 步骤是可选增强只有当你想写agent.act(升级工作区到 Pro 套餐)这类自然语言步骤时才需要接入模型。零成本起步官方文档明确说明“不含 agent 步骤的测试不需要模型”Tests without agent steps need no model首次运行示例测试时没有任何模型调用无需登录、无需 API Key。相关文档docs/quickstart.mdx最快安装步骤一条命令初始化在应用目录下执行一条命令即可npx e2e init向导会依次问你两件事选引擎Web (Playwright)或Mobile (iOS/Android)选模型提供方这里直接选None不配置 AI 的纯测试模式。向导会自动写好e2e.config.ts配置和一个示例测试并保留你已有的文件不受影响。配置完成后启动你的应用例如http://localhost:3000然后运行npx e2e rune2e 会自动下载浏览器、打开应用、检查页面、生成.e2e/report.json报告。全程没有模型调用所以不需要任何登录或密钥。环境要求Node.js 24.8或 Node 22.22.3Windows 建议在 WSL 内运行。怎么写不依赖模型的确定性 e2e 测试核心就三个构件app打开页面、screen定位元素、expect断言结果。官方 docs/locators.mdx 的定义是“用定位器操作已知控件并检查精确值定位器步骤不调用任何模型。”仓库里的示例测试非常直观examples/with-vite/tests/greeting.e2e.tstest(greets the name you type, async ({ app, screen }) { await app.open(/); await screen.getByLabel(Name).fill(Ada); await screen.getByRole(button, Greet).click(); await expect(screen.getByRole(status)).toHaveText(Hello, Ada!); });这就是一个标准的确定性 e2e 测试填输入框 → 点按钮 → 断言文案。没有一处需要 AI跑得又快又稳。定位查询的推荐顺序语义化优先方法用法适用场景getByRole(button, Sign in)角色 名称按钮、链接等交互控件getByLabel(Email)表单标签输入框getByTestId(todo)测试 ID无语义元素零配置模型时运行行为是什么样的只含定位器/断言的测试直接运行正常通过或失败报告里没有任何 AI 消耗如果某条测试里写了agent.act但没配模型该步骤会以MODEL_UNAVAILABLE报错——所以“None”模式下只写确定性步骤即可这正是本指南推荐的起步方式官方示例项目也做了同样的保护没有密钥时 agent 测试自动跳过确定性测试照常全绿见 examples/with-vite/tests/agent.e2e.ts。以后想加 AI 步骤缓存让成本趋近于零这是 e2e 框架最有意思的机制之一详见 docs/cache.mdx第一次运行agent.act(…)时模型驱动 App 完成目标后面的断言验证通过运行器就把这串动作录制下来之后每次运行运行器直接**回放replay**这些动作不再调用模型只有当 UI 变了、回放失配时agent 才从当前屏幕接管重新录制。也就是说AI 只付“第一次”的钱后续 CI 里反复跑都是零模型成本。想排查问题时还可以加--no-cache强制走模型。回放缓存的源码在 packages/e2e/src/agent/step-cache.ts。现成的四个入门示例不想从零搭项目仓库自带四个独立示例Web 移动端全覆盖每个都含 3 个确定性测试 2 个 agent 测试examples/with-vite/ —— Vite Reactexamples/with-next/ —— Next.js App Routerexamples/with-expo/ —— Expo React NativeWeb/iOS/Androidexamples/with-swiftui/ —— SwiftUI进入任意目录执行npm install后运行npm run test:e2e即可。agent 测试需要AI_GATEWAY_API_KEY没有则自动跳过不影响确定性测试的运行。总结零成本上手清单npx e2e init引擎选 Web 或 Mobile模型选None写好app.open()screen.getBy*expect三步式确定性测试npx e2e run直接跑通零模型调用、零 API Key未来想写自然语言步骤时再接入订阅或 API Key靠回放缓存把长期成本压到最低。e2e 测试框架的这套“确定性打底、AI 增强、缓存兜底”的设计让新手可以真正零成本迈出 e2e 测试的第一步。更多参考快速上手 · 定位器 · 回放缓存 · 模型配置 · 定位器与测试包【免费下载链接】e2eNext generation e2e testing framework for web and mobile apps.项目地址: https://gitcode.com/GitHub_Trending/e2e6/e2e创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考