‏e2e: فریم‌ورک تست متن‌باز با هوش مصنوعی

e2e یه فریم‌ورک تست end-to-end متن‌باز برای TypeScript هست که تیم TesterArmy ساخته و روی وب، iOS و Android کار می‌کنه. ایدهٔ اصلیش ترکیب دو جور تسته: مراحلی که با زبان ساده به یه ایجنت هوش مصنوعی می‌سپری، و مراحل قطعی (deterministic) که مثل Playwright با locator و assertion دقیق می‌نویسی.

مشکلی که حل می‌کنه اینه که بیشتر تست‌های مبتنی بر هوش مصنوعی هر بار از صفر شروع می‌کنن و مدل باید دوباره همون کلیک‌ها رو بفهمه. e2e کارهایی که ایجنت انجام داده رو کش می‌کنه و اگه چیزی عوض نشده باشه، دفعهٔ بعد همونا رو بدون صدا زدن مدل replay می‌کنه. یعنی توکن کمتر، هزینهٔ کمتر و تستی که تو CI کمتر flaky (یعنی گاهی پاس و گاهی فیل) می‌شه.

نمونه‌ای که خود سایت نشون می‌ده این ترکیب رو خوب نشون می‌ده: دو قدم وسط با زبان طبیعی به ایجنت داده شدن و آخرش یه assertion معمولی اومده.

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

انتخاب مدل با خودته. هر مدلی که AI SDK پشتیبانی کنه کار می‌کنه: می‌شه با اشتراک ChatGPT، GitHub Copilot یا SuperGrok وارد شد، کلید Vercel AI Gateway یا OpenRouter داد، یا به یه سرور محلی وصل شد. تو فایل e2e.config.ts هم target (مثلاً وب یا موبایل)، مدل و system prompt ایجنت رو تعیین می‌کنی. برای موبایل، پکیج @e2e-dev/mobile از طریق agent-device شبیه‌سازهای iOS و Android رو اجرا می‌کنه.

تو CI حالت مخصوص خودش خودکار روشن می‌شه: یه بار retry، کش trace فقط‌خواندنی، و replay مراحل ایجنت بدون مدل وقتی چیزی عوض نشده. secretها تو متغیرهای محیطی می‌مونن و وارد کد تست نمی‌شن. برای مهاجرت از Playwright، Cypress، Selenium، Detox و Maestro هم راهنما هست. وقتی تستی فیل بشه، گزارش با مرحلهٔ دقیق، اسکرین‌شات، trace و لاگ تو پوشهٔ .e2e ذخیره می‌شه.

نکات کلیدی:

• e2e متن‌بازه و برای TypeScript ساخته شده
• کارهای ایجنت کش می‌شن و بدون صدا زدن دوبارهٔ مدل replay می‌شن
• مراحل ایجنتی و assertionهای قطعی تو یه تست کنار هم میان
• وب، iOS و Android با یه API مشترک پشتیبانی می‌شن
• راهنمای مهاجرت از Playwright، Cypress، Selenium، Detox و Maestro داره