محوّلات الاختبار الآلي
استخدم المحوّلات الرسمية لربط الاختبارات الآلية بحالات Tracera ورفع النتائج.
ما تحتاجه
- عنوان المثيل (
TRACERA_BASE_URL). - رمز Autotest للمشروع (
TRACERA_AUTOTEST_TOKEN) — إعدادات المشروع → Autotest (انظر الرموز). - معرّف المشروع (
TRACERA_PROJECT_ID). - معرّف حالة الاختبار (
testCaseId) من بطاقة الحالة.
المتطلبات
- Node.js ≥ 22.19 (جميع محوّلات JS).
- Cypress ≥ 14 عند استخدام
@tracera/cypress. - WebdriverIO ≥ 9 عند استخدام
@tracera/webdriverio.
البيئة
يقرأ المحوّل كل متغير من بيئة العملية أولًا. إن لم يكن المفتاح مضبوطًا (أو كان فارغًا)، يستخدم أقرب ملف .env بدءًا من دليل العمل وصعودًا إلى المجلدات الأب (وليس مجلد المنزل). بيئة العملية تفوز دائمًا.
| المتغير | مطلوب | الوصف |
|---|---|---|
TRACERA_BASE_URL | نعم | عنوان URL للمثيل |
TRACERA_AUTOTEST_TOKEN | نعم | رمز Autotest للمشروع |
TRACERA_PROJECT_ID | نعم | معرّف المشروع |
TRACERA_TEST_RUN_ID | لا | الإبلاغ إلى تشغيل موجود (تقرير فقط؛ بلا إنهاء). بدونها يُنشأ تشغيل جديد |
TRACERA_RUN_TITLE | لا | عنوان التشغيل الجديد (≤128). عند إنشاء تشغيل فقط؛ يُتجاهل إن وُجد TRACERA_TEST_RUN_ID |
TRACERA_REQUIRE_REPORT | لا | الافتراضي false؛ true → إفشال المجموعة إن تعذّر إنشاء تشغيل أو فشل رفع النتائج |
TRACERA_LOG_LEVEL | لا | error أو warn أو info (الافتراضي) أو debug |
وضع التشغيل
- بدون
TRACERA_TEST_RUN_ID— ينشئ المحوّل تشغيلًا فارغًا، يرفع النتائج إليه، وينهيه عند انتهاء المجموعة. - مع
TRACERA_TEST_RUN_ID— تقرير فقط إلى ذلك التشغيل؛ المحوّل لا ينهيه.
العدّاءات
JavaScript
Python
لاحقًا (pytest، …).
JVM
لاحقًا (JUnit، TestNG، …).
.NET
لاحقًا (NUnit، …).