QATrax
عرض بصيغة Markdown

صيغة نتائج الاختبارات

JUnit XML، NUnit، TRX، TestNG، Robot Framework، CTest، Cucumber، Behave، Allure، CTRF، TAP أو JSON — القاعدة المشتركة، وما يجب أن تحمله كل صيغة، ونماذج للتنزيل.


لا يشغّل QATrax اختباراتك: بل يستلم ما نفّذه نظام التكامل المستمر لديك، ويربطه بمتطلباتك. يقرأ التقرير كما تكتبه أداتك، ويتعرّف عليه من محتواه — لا محوّل تكتبه، ولا أداة تغيّرها. وهي الصيغ نفسها التي تقرؤها أيضًا Xray وAllure TestOps وTestRail وZephyr وReportPortal و Azure DevOps: يبقى تقريرك ملكك.

الصيغةمن ينتجهاما يُودع
JUnit XMLpytest (--junitxml)، Maven Surefire، Gradle، Jest (jest-junit)، Go (gotestsum)، GitLab، Jenkins، mjs-unit --junitملف .xml — الأكثر شيوعًا
NUnit 2 و3nunit3-console، NUnit3TestAdapterTestResult.xml
TRXdotnet test --logger trx (xUnit، MSTest، NUnit)ملف .trx
TestNGTestNG (Maven، Gradle)testng-results.xml
Robot Frameworkrobot (6 و7)output.xml
CTestctest -T Test (C، C++)Testing/<date>/Test.xml
Cucumber JSONcucumber-js، Cucumber-JVM، Cucumber Ruby (--format json)ملف .json
Behave JSONbehave -f json -o behave.jsonملف .json
Allure 2أي لغة (allure-results/)ملف -result.json واحد، أو كلها مجمَّعة: jq -s . allure-results/-result.json > allure.json
CTRFمُبلِّغات ctrf-io، mjs-unit --ctrfملف .json
TAPnode --test، prove، pytest-tapالأبسط كتابةً باليد
JSONmjs-unit --json، أو سكربتك الخاصحين تصنع التقرير بنفسك

الحالة التي ليست ناجحة ولا فاشلة ولا متجاهَلة — Inconclusive (NUnit، TRX)، أو خطوة undefined أو pending (Cucumber، Behave)، أو unknown (Allure)، أو notrun لملف تنفيذي غائب (CTest) — تُحتسب معطّلة: وليس أبدًا نجاحًا. وتُعرض طريقة إعداد TestNG الفاشلة، تحت اسمها. Allure: الاختبار المُعاد تشغيله (بالمعرّف historyId نفسه) لا يُحتسب إلا مرة واحدة، الأخيرة.

القاعدة المشتركة: مرجع الاختبار في بداية الاسم

تعطي خطتك كل اختبار مرجعًا (T-MOD-01) وautoRef: <fichier de test>::<référence>. اسم كل اختبار، في التقرير، يبدأ بهذا المرجع، يليه فاصل (·، —، : أو -):

T-MOD-01 · aucune vulnérabilité connue non traitée

وإن كُتب بـ _ — كما يفرض pytest وJUnit، اللذان يرفضان الشرطة في اسم الدالة —، فإنه يُتعرَّف عليه أيضًا: test_T_MOD_01_aucune_vulnerabilite.

في BDD (Cucumber، Behave)، ومع Robot Framework أو Allure، يكفي وسم مساوٍ للمرجع: @T-MOD-01 على السيناريو. وإن حمل الاسم مرجعًا، فله الأولوية.

الاختبار الذي لا يحمل مرجعًا معروفًا في الخطة يُبلَّغ عنه بأنه خارج الخطة: يُعرض، ولا يثبت شيئًا.

JUnit XML

نزّل النموذج: resultats-modele.xml.

مع mjs-unit (الإصدار 0.8.0 وما بعده): mjs-unit test-scripts/*.test.mjs --junit=junit.xml.

TAP

نزّل النموذج: resultats-modele.tap.

ok N - <nom> ناجح، not ok N - <nom> فاشل، # SKIP أو # TODO لم يُشغَّل. الملف غير مطلوب: يعثر عليه QATrax في الخطة.

JSON

نزّل النموذج: resultats-modele.json.

{
  "title": "Produit modèle — campagne de sécurité",
  "generatedAt": "2026-10-03T09:12:00.000Z",
  "suites": [
    { "file": "test/acces.test.mjs",
      "results": [
        { "name": "T-MOD-03 · un appel sans jeton est refusé (401)", "status": "pass", "durationMs": 8.3 },
        { "name": "T-MOD-04 · un jeton expiré est refusé (401)", "status": "fail", "error": "attendu 401, reçu 200" }
      ] }
  ]
}
الحقلإلزاميالقاعدة
suites[].fileنعمملف الاختبار، كما في autoRef؛ إن اختلف، يعثر عليه المرجع حين لا يوجد إلا في ملف واحد
results[].nameنعمالمرجع في البداية
results[].statusنعمpass، fail، skip (وأيضًا passed، failed، error، skipped، todo)؛ أي كلمة أخرى تصبح «معطّل»، وليس أبدًا «ناجح»
error، durationMsلارسالة الفشل، والمدة بالميلي ثانية
generatedAtموصى بهيعرّف التنفيذ: تاريخ جديد مع كل تنفيذ، وإلا عُدّ الإيداع مستلَمًا من قبل

الاختبارات اليدوية

المراجعة الوثائقية، والفحص، والاختبار على منصة: كثير من متطلبات CRA لا تُثبت بالتكامل المستمر. أعلن الحالة يدوية في الخطة ("type": "manual"، مع خطواتها)، ثم أدخل نتيجتها في تبويب الاختبارات اليدوية: ناجح، أو فاشل، أو معطّل، وتاريخ التنفيذ ومكانه، والمعاينة (إلزامية)، و المرفقات (محضر، صورة؛ 5 ميغابايت كحد أقصى لكل منها).

إلغاء إيداع خاطئ

التقرير المُرسل خطأً (فرع خاطئ، مشروع خاطئ) يُلغى من تبويب «التنفيذات»، مع سبب: يبقى في السجل، موسومًا بأنه ملغى (من، متى، لماذا)، لكنه لم يعد يُحتسب في الحكم. ويمكن استعادته بالطريقة نفسها. والإدخال اليدوي الخاطئ يُلغى بالطريقة ذاتها. تحتفظ المُسلَّمات الصادرة سلفًا بما ختمته؛ ويذكر المُسلَّم التالي الإيداعات الملغاة.

الخطة

نزّل النموذج: plan-modele.json — ثلاثة متطلبات من CRA، وأربعة اختبارات. أودعه (تبويب «المتطلبات»)، ثم أحد نماذج النتائج الثلاثة: تُربط الاختبارات الأربعة، ويفشل أحدها — فترى ما يؤول إليه متطلب فاشل، وصولًا إلى الحكم.

الإيداع

يبيّن الرد الصيغة المتعرَّف عليها (dialecte)، والاختبارات المرتبطة، وتلك الخارجة عن الخطة، واختبارات الخطة التي لم تُنفَّذ قط.