Tracera
بدء التجربة

محوّلات الاختبار الآلي

استخدم المحوّلات الرسمية لربط الاختبارات الآلية بحالات Tracera ورفع النتائج.

قبل البدء

  1. عنوان المثيل (TRACERA_BASE_URL).
  2. رمز Autotest للمشروع (TRACERA_AUTOTEST_TOKEN) — إعدادات المشروع → Autotest (انظر الرموز).
  3. معرّف المشروع (TRACERA_PROJECT_ID).
  4. معرّف حالة الاختبار (testCaseId) من بطاقة الحالة.

المتطلبات

مُختبَر على:

  • Node.js 22.19–26.12 (جميع محوّلات JS).
  • Python 3.11–3.15 (جميع محوّلات Python).
  • JDK 17–27 (جميع محولات JVM).
  • .NET 8–10 (جميع محوّلات .NET).
  • Go 1.25–1.27 (جميع محوّلات Go).
  • Dart 3.8–3.13 (جميع محوّلات Dart).
  • Swift 6–6.4 (macOS 15–27 / Xcode 16–27؛ جميع محوّلات Swift).

البيئة

يقرأ المحوّل كل متغير من بيئة العملية أولًا. إن لم يكن مفتاح TRACERA_* مضبوطًا أو كان فارغًا، يملأه من أقرب ملف .env بدءًا من دليل العمل وصعودًا إلى المجلدات الأب (وليس مجلد المنزل). تُتجاهل بقية المفاتيح في الملف. قيمة غير فارغة من بيئة العملية تفوز على .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 — تقرير فقط إلى ذلك التشغيل؛ المحوّل لا ينهيه.

لبدء CI من الواجهة عبر تشغيل أو إعادة تشغيل لتشغيل اختبار، انظر التكاملات.

الخطافات

فقط خطافات مستوى الاختبار تُطابق الإعداد / التنظيف الخاصة بالنتيجة. خطافات مستوى المجموعة لا تُبلَّغ كخطوات. إذا فشل إعداد المجموعة وما زال المُشغِّل يجدول الاختبارات المربوطة، تُبلَّغ Failed مع نص ذلك الخطأ على النتيجة (عادة بدون خطوات). تنظيف مستوى المجموعة لا يغيّر نتائج انتهت بالفعل كـ Passed.

إعادة المحاولة

عند إعادة محاولة اختبار Failed يُبلَّغ عن المحاولة النهائية فقط. عند إعادة محاولة الاختبار الآلي (retry > 0) يظهر مفتاح خاص بالعدّاء في تبويب Env مثل PLAYWRIGHT_RETRY أو JEST_RETRY (1 تعني التشغيل الثاني). صفحات العدّائين الذين يدعمون إعادة المحاولة تذكر اسم مفتاح Env هذا.

التعليقات والأخطاء والمرفقات

tracera.comment وtracera.error وtracera.attachment تُضاف إلى الخطوة الحالية عند الاستدعاء داخل خطوة؛ خارج أي خطوة — إلى النتيجة.

tracera.error يضيف نص خطأ فقط — ولا يُفشل الاختبار. للإبلاغ عن Failed استخدم واجهة الفشل في الـ runner.

حدود المرفقات

الحدالقيمة
لكل خطوةحتى 10 ملفات
لكل نتيجة (خارج الخطوات)حتى 10 ملفات
حجم الملفحتى 50 MB لكل ملف

يحدّد الخادم النوع من المحتوى وامتداد الملف. الأنواع غير المدعومة تُرفض (خطأ رفع في سجل المحوّل).

الأنواع المسموحة

صور: image/png، image/jpeg، image/gif، image/webp
مستندات / بيانات: text/plain، text/csv، application/pdf، application/json، application/xml، application/zip
أرشيف: application/gzip، application/x-tar
فيديو: video/webm، video/mp4
ملفات أخرى: application/octet-stream

العدّاءات

JavaScript: Playwright JS، Cypress، WebdriverIO، Jest، Vitest

Python: Pytest، Playwright Python، Robot Framework، Behave

JVM: JUnit 5، TestNG، Kotest، Cucumber JVM، Android

.NET: NUnit، xUnit، Reqnroll

Go: gotest، Ginkgo، Godog

Dart: dart-test، Flutter

Swift: Swift Testing، XCUITest