English Français العربية

e2e

السجل الرسمي أخرى

Open live web and mobile app sessions from an e2e project to inspect the app and try locators.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package e2e
Claude Code 
claude mcp add e2e -- npx -y e2e@0.21.3 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "e2e": {
            "command": "npx",
            "args": [
                "-y",
                "e2e@0.21.3",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. e2e
  2. Quick start
  3. Packages
  4. Documentation
  5. Contributing
  6. Security
  7. Telemetry
  8. Status
  9. Made by TesterArmy

e2e

e2e is an end-to-end testing framework for web and mobile apps. Describe a goal in natural language and an agent drives the app to reach it. Check the result with locators and assertions in the same test.

// 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');
});

An agent step that a later assertion verifies records its actions, and the next run replays them with no model calls until the app changes. Tests without agent steps need no model. Bring your own subscription, API key, or local model.

Quick start

npx e2e init

init asks for an engine, web or mobile, and a model provider, then writes a config and an example test. The quickstart covers the rest.

To see a finished setup in your stack, open examples/: Vite, Next.js, Astro, Expo, SwiftUI, Jetpack Compose, Kotlin Multiplatform, Flutter, and .NET MAUI, each a standalone project with a passing suite.

Packages

PackageWhat it does
e2eThe SDK, runner, and CLI.
@e2e-dev/webBrowser engine: Chromium, Firefox, and WebKit through Playwright.
@e2e-dev/mobileiOS and Android engine: simulators and emulators through agent-device.
@e2e-dev/githubReporter that posts results as a pull request comment.
@e2e-dev/kernelKernel hosted browsers for the web engine.
@e2e-dev/lightpandaLightpanda, the open-source headless browser, started per run for the web engine.
@e2e-dev/limrunLimrun hosted iOS simulators and Android emulators for mobile tests.
@e2e-dev/easEAS Simulators hosted iOS simulators and Android emulators for the mobile engine.
@e2e-dev/smolsmol machines browsers for the web engine: by default, each attempt branches a warm Chromium microVM.
@e2e-dev/decisionDecision-model executors for bounded semantic actions and assertions, and decisionFilter(), which leaves out the tests a pull request is unlikely to affect.
@e2e-dev/testmuTestMu AI (formerly LambdaTest) hosted Android emulators, iOS simulators, and real devices for the mobile engine, and hosted Chrome and Edge for the web engine.

Documentation

e2e.tester.army/docs. The e2e package ships every page, so coding agents can read them offline in node_modules/e2e/docs.

Contributing

See CONTRIBUTING.md. Questions go to Discord.

Security

Please don't open public issues for security vulnerabilities. Follow SECURITY.md and report them to security@tester.army.

Telemetry

The CLI sends anonymous usage data, such as which commands and engines run and where runs fail, but no test content, app content, or credentials. Opt out with npx e2e telemetry disable or E2E_TELEMETRY_DISABLED=1. Telemetry lists every field.

Status

[!NOTE] e2e is in active development on the way to 1.0. APIs and config can still change between minor releases.

Made by TesterArmy

e2e is built by TesterArmy, the agentic testing platform that runs natural language tests on web and mobile apps, on every pull request or on a schedule.

Apache-2.0.

الأسئلة الشائعة

ما هو e2e؟

Open live web and mobile app sessions from an e2e project to inspect the app and try locators.

كيف أثبّت e2e؟

يعمل على جهازك. في Claude Code: claude mcp add e2e -- npx -y e2e@0.21.3 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج e2e إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل e2e مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون e2e؟

ينشره tester-army. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.