What problem it solves

Teams need to express application goals and verify outcomes without relying only on manually scripted interactions. The framework addresses this by combining natural-language agent actions with locators and assertions in the same test.

Key features

• Natural-language agent steps — Tests can describe a goal in natural language and let an agent drive the application toward it.

  Source: README

• Web and mobile engines — The framework provides browser and mobile engines, including Chromium, Firefox, WebKit, simulators, and emulators.

  Source: README

• Recorded agent-step replay — Verified agent actions can be recorded and replayed on later runs without model calls until the application changes.

  Source: README

• Choice of model provider — Users can select a model provider during setup and bring their own subscription, API key, or local model.

  Source: README

Quick start

Copied verbatim from the project's README.

npx e2e init

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

Who it may suit

This may suit web and mobile application teams that want to combine agent-driven interactions with conventional locators and assertions. It may also suit developers who want to choose their own model provider or reuse recorded agent actions.

Topics to discuss

• How should natural-language agent steps and conventional assertions be balanced in end-to-end tests?

• Which applications of recorded agent-step replay would provide the most value?

• How should model selection and support for local models affect testing workflows?

Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/tester-army/e2e#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.