e2e: فريمورك اختبار بالذكاء الاصطناعي من فريق Callstack للويب والموبايل

🔗 رابط المشروع على GitHub: https://github.com/tester-army/e2e

🌐 الموقع الرسمي: tester.army/e2e

📘 التوثيق: e2e.tester.army/docs

---

الـ End-to-End testing (اختبار من البداية للنهاية) كان دايماً أصعب جزء في تطوير التطبيقات. الـ selectors بتتكسر، الـ CSS classes بتتغيّر، والـ tests بتفشل لأسباب مش حقيقية. الفرق اللي بيستخدم Playwright أو Cypress أو Selenium بيقضي وقت أكتر في صيانة الاختبارات نفسها من تطوير المنتج.

e2e من TesterArmy (فريق Callstack المعروف في مجتمع React Native) هو جيل جديد من فريمورك الاختبار: بتوصف الهدف بالإنجليزي، وفيه agent بيتعامل مع التطبيق لتحقيقه. ومعاه برضه الـ locators والـ assertions الكلاسيكية لو عايز تحقق من نتيجة محددة.

الـ repo بيحصد نجوم بسرعة، مرخّص Apache 2.0، وبيدعم Web + Mobile (iOS + Android) في فريمورك واحد.

كيف يبدو الاختبار؟

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

شوف الاختلاف: agent.act بيدي الـ agent الهدف بلغة طبيعية، وagent.assert بيتحقق إن النتيجة المتوقعة ظهرت. وفي النهاية، expect(screen.getByRole) الكلاسيكي للتحقق من نص محدد.

الاتنين في اختبار واحد. ده الفرق الأساسي: Hybrid بدل اختيار بين deterministic أو agentic.

الـ Features الأساسية

1) 🧠 Agentic + Classic في اختبار واحد

• agent.act('goal') — تدي الـ agent هدف ويحقّقه بأي طريقة
• agent.assert('expected state') — تدي الـ agent تحقّق ذكي
• screen.getByRole()، expect(...) — الـ Playwright-style الكلاسيكي للـ assertions الدقيقة

2) 🔁 Smart Replay — بدون model calls

ديه النقطة الذكية جداً. أول مرة الاختبار بيشتغل، الـ agent يستخدم الـ model (ChatGPT/Claude/Grok) ويسجّل الـ actions. المرات اللي بعدها، الاختبار يعيد نفس الـ actions بدون أي model call لحد ما التطبيق يتغيّر فعلاً.

النتيجة: اختبارات AI بسرعة اختبارات deterministic، وبتكلفة تقريباً صفر على المدى الطويل.

3) 📱 Web + Mobile في فريمورك واحد

• @e2e-dev/web — محرك المتصفح
• @e2e-dev/mobile — محرك iOS و Android
• @e2e-dev/kernel — متصفحات مستضافة (Kernel)
• @e2e-dev/eas — EAS Simulators لـ iOS و Android emulators

تقدر تختبر تطبيق Next.js وتطبيق React Native بنفس الـ API.

4) 🔑 Bring Your Own Key

مش محتاج تدفع subscription تاني لـ e2e. استخدم:

• اشتراك ChatGPT Plus اللي عندك
• اشتراك GitHub Copilot
• اشتراك SuperGrok
• أي AI SDK model عبر Vercel AI Gateway
• Local model على جهازك

5) 🔄 GitHub PR Integration

@e2e-dev/github يضيف comments على الـ pull requests بنتيجة الاختبارات مع screenshots و recordings.

Quickstart

npx e2e init

كده بس. الـ CLI بيعمل setup كامل.

Migration من فريمورك تاني

e2e موفّر أدلة migration من:

• Playwright (الأقرب في الـ API)
• Cypress
• Selenium
• Detox (React Native)
• Maestro (mobile)

وفي ميزة لذيذة: الـ package نفسه يشحن كل صفحات التوثيق جوه node_modules/e2e/docs، فـ coding agents زي Claude Code وCursor تقدر تقراها offline بدون internet.

الـ Packages

• e2e — SDK + runner + CLI
• @e2e-dev/web — browser engine
• @e2e-dev/mobile — iOS + Android engine
• @e2e-dev/github — PR comments reporter
• @e2e-dev/kernel — hosted browsers
• @e2e-dev/eas — hosted simulators

سيناريو Ibrahim المباشر

• كورس Vibe Coding — المشاكل الحقيقية مع التطبيقات المبنية بـ AI إنها بتفشل في production. درس عن “ازاي تختبر SaaS بناه الـ AI في 10 دقائق” باستخدام e2e هيبقى من أقوى دروس الكورس. الطلاب بينتجوا كود كتير بـ Claude، وe2e هو الـ safety net.
• مشاريع SaaS القادمة — CRM، doctors، expenses، lecture-docs — كلها محتاجة e2e testing. اختبار واحد بـ agent.act('register a new doctor and book appointment') يغطي 20 خطوة UI.
• bond (video reels) — لو فيه mobile app component، @e2e-dev/mobile يختبره على iOS + Android بنفس الكود.
• faahm.com — اختبر course purchase flow، signup، login، lesson playback بـ 10 أسطر.
• فرصة agency — خدمة “QA Automation Setup” لعملاء DSE اللي بيدخلوا production. سعر: 20-40 ألف جنيه حسب التعقيد.

مين وراه؟

الفريق Callstack — نفس الفريق اللي ورا Re.Pack وReact Native CLI وReact Native tools الكتير. ده بيدي الـ repo credibility فورية في المجتمع. أسماء زي Szymon Rybczak وKacper Kapuściak وOskar Kwaśniewski بيروّجوله.

📎 رابط المشروع: github.com/tester-army/e2e