blog.dopana

Quay lại

Bạn đã bao giờ cảm thấy mệt mỏi khi phải viết hàng chục dòng code chỉ để kiểm thử một luồng người dùng đơn giản? Hay đau đầu khi UI thay đổi và tất cả các test của bạn đều bị vỡ? e2e là một framework kiểm thử end-to-end thế hệ mới sử dụng AI để giải quyết những vấn đề này.

Trong bài viết này, chúng ta sẽ khám phá e2e hoạt động như thế nào và tại sao nó có thể thay đổi cách bạn viết test.

Tại sao cần e2e?#

Hãy tưởng tượng bạn đang kiểm thử quy trình đăng ký tài khoản. Với các framework truyền thống như Playwright hay Cypress, bạn phải viết:

await page.click('button[name="signup"]');
await page.fill('input[name="email"]', 'test@example.com');
await page.fill('input[name="password"]', 'password123');
await page.click('button[type="submit"]');
await expect(page.locator('.welcome-message')).toBeVisible();
typescript

Nếu button đổi tên hoặc layout thay đổi, test của bạn sẽ thất bại. Bạn phải sửa code thủ công.

Với e2e, bạn chỉ cần nói với AI:

await agent.act('sign up with email {email}', {
  params: { email: 'test@example.com' }
});
await agent.assert('the welcome screen is showing');
typescript

AI tự động tìm cách thực hiện hành động và kiểm tra kết quả. Khi UI thay đổi, AI thích nghi tự động.

e2e là gì?#

e2e là một framework kiểm thử end-to-end mã nguồn mở cho web và mobile apps, được thiết kế để theo kịp tốc độ phát triển phần mềm hiện nay. Điểm đặc biệt:

  • AI-driven: Sử dụng AI model để thực hiện các hành động và kiểm tra kết quả
  • Deterministic: Cũng hỗ trợ API truyền thống với locators và assertions
  • Hybrid: Bạn có thể kết hợp cả hai cách trong cùng một test
  • Cross-platform: Chạy test trên web (Chromium), iOS, và Android

Cách e2e hoạt động#

e2e có 3 thành phần chính:

Test FileTargetsWeb / iOS / AndroidAgent Stepsagent.act / agent.assertCacheReplay verified stepsEnginesPlaywright for Webagent-device for MobileAI ModelExecute ActionsJudge ScreenNo Model CallsFast & Cheap

Targets#

Mỗi test chạy một lần cho mỗi target:

  • Web: Chromium, Firefox, Safari thông qua Playwright
  • Mobile: iOS simulator và Android emulator thông qua agent-device
  • Custom: Bạn có thể viết engine riêng cho platform khác

Agent Steps#

  • agent.act: Hoàn thành một mục tiêu (goal) bằng ngôn ngữ tự nhiên
  • agent.assert: Kiểm tra một điều kiện trên màn hình
  • agent.waitFor: Đợi một điều kiện trở thành true
  • agent.extract: Trích xuất dữ liệu có cấu trúc từ màn hình

Cache#

Các bước act đã được xác minh sẽ được ghi lại và replay từ cache mà không cần gọi AI model. Điều này giúp:

  • Giảm chi phí token
  • Tăng tốc độ chạy test
  • Giữ lại hành động cũ khi app không thay đổi

Bắt đầu với e2e#

Cài đặt nhanh#

npx e2e init
bash

Lệnh này sẽ:

  • Tạo file cấu hình e2e.config.ts
  • Tạo test ví dụ
  • Thêm dependencies
  • Thiết lập coding agent của bạn

Cấu hình cho Web#

e2e.config.ts
import type { E2EConfig } from 'e2e';
import { web } from '@e2e-dev/web';
import { gateway } from 'ai';

export default {
  agents: { default: { model: gateway('openai/gpt-6-luna-fast') } },
  targets: [{ engine: web(), app: { url: 'http://localhost:3000' } }],
} satisfies E2EConfig;
typescript

Test đầu tiên#

tests/example.e2e.ts
import { test } from '@e2e-dev/web';
import { expect } from 'e2e';

test('app opens', async ({ app, browser }) => {
  await app.open('/');
  await expect(browser.locator('body')).toBeVisible();
});
typescript

Chạy test:

npx e2e run
bash

Viết test với AI#

Agent Actions#

import { test } from '@e2e-dev/web';
import { expect } from 'e2e';

test('a visitor signs up for a trial', async ({ app, agent, screen }) => {
  await app.open('/');

  await agent.act('sign up for a free trial as {name} with email {email}', {
    params: { name: 'Ada Lovelace', email: 'ada@example.test' },
  });

  await agent.assert('the welcome screen greets Ada by name');
  await expect(screen.getByRole('status')).toContainText('trial');
});
typescript

Kết hợp Deterministic và AI#

test('todos survive a filter round-trip', async ({ app, agent, screen }) => {
  await app.open('/todos');

  // AI handles complex interaction
  await agent.act('add todos "Buy milk" and "Walk the dog", complete the first');
  await agent.assert('only one todo remains open');

  // Deterministic check for exact value
  await screen.getByRole('tab', 'Done').tap();
  await expect(screen.getByTestId('todo')).toHaveCount(1);
});
typescript

Kết hợp cả hai cách#

e2e cho phép bạn mix agent steps với deterministic APIs trong cùng một test:

  • Agent steps: Khi bạn không biết chính xác hành động cần làm
  • Deterministic APIs: Khi bạn cần kiểm tra giá trị chính xác hoặc đã biết locator
// Agent handles complex flow
await agent.act('complete checkout with the test card');

// Deterministic check for exact result
await expect(screen.getByText('Order #12345')).toBeVisible();
typescript

Lợi ích của e2e#

Tiết kiệm thời gian#

Viết một mục tiêu thay vì script dài. Khi UI thay đổi, AI thích nghi tự động.

Giảm rủi ro#

Bao phủ nhiều luồng người dùng quan trọng hơn trên cả web và mobile.

Chi phí thấp#

Các bước agent.act đã xác minh replay từ cache, không cần gọi model.

Xác thực và Secret#

e2e có built-in support cho secrets:

import { credentials } from 'e2e';

const member = credentials.user('member');
await agent.act('Sign in', {
  params: { username: member.username, password: member.password },
});
typescript

Secret được redacted khỏi input của model để bảo mật.

Mobile Testing#

e2e cũng hỗ trợ iOS và Android:

e2e.config.ts
import { mobile } from '@e2e-dev/mobile';

export default {
  targets: [{
    name: 'ios',
    engine: mobile({ platform: 'ios' }),
    app: { bundleId: 'com.yourapp' }
  }],
  workers: 1,
} satisfies E2EConfig;
typescript
tests/mobile.e2e.ts
import { test } from '@e2e-dev/mobile';

test('the agent opens General', async ({ agent, app, device }) => {
  await app.open();
  await agent.act('open {section} settings', { params: { section: 'General' } });

  await agent.assert('the General settings screen is showing');
  await expect(device.locator('role=NavigationBar id=General')).toBeVisible();
});
typescript

Coding Agents#

e2e được thiết kế để làm việc với coding agents như Claude, Cursor, Codex. Sau khi setup, bạn có thể:

  • “Add a test for checkout”
  • “Why did this run fail?”
  • “Debug this test”

Agent tự động đọc skill và thực hiện các hành động cần thiết.

Kết luận#

e2e đại diện cho một bước tiến lớn trong kiểm thử end-to-end. Bằng cách kết hợp AI với deterministic APIs, nó cho phép bạn:

  • Viết test nhanh hơn
  • Duy trì test dễ hơn
  • Bao phủ nhiều luồng người dùng hơn
  • Chạy test trên nhiều platform

Nếu bạn đang tìm kiếm một cách hiện đại hơn để kiểm thử ứng dụng của mình, e2e đáng để thử.

References#