ऑटोटेस्ट एडेप्टर

आधिकारिक एडेप्टर से ऑटोमेटेड टेस्ट को Tracera केस से बाँधें और परिणाम अपलोड करें।

शुरू करने से पहले

  1. इंस्टेंस URL (TRACERA_BASE_URL)।
  2. प्रोजेक्ट Autotest टोकन (TRACERA_AUTOTEST_TOKEN) — प्रोजेक्ट सेटिंग्स → Autotest (देखें टोकन)।
  3. प्रोजेक्ट id (TRACERA_PROJECT_ID)।
  4. केस कार्ड से टेस्ट केस id (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हाँप्रोजेक्ट 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 सेट करें — केवल उसी रन में परिणाम भेजना; एडेप्टर उसे समाप्त नहीं करता।

UI से टेस्ट रन पर चलाएँ या पुनः रन के ज़रिए CI शुरू करने के लिए देखें एकीकरण।

हुक्स

केवल प्रति-टेस्ट हुक्स परिणाम के सेटअप / टीयरडाउन में जाते हैं। सूट-स्तरीय हुक्स स्टेप के रूप में रिपोर्ट नहीं होते। सूट-स्तरीय सेटअप फेल होने पर भी अगर रनर बाउंड टेस्ट चलाता है, तो वे Failed होते हैं — उसी त्रुटि के साथ परिणाम पर (आमतौर पर बिना स्टेप)। सूट-स्तरीय टीयरडाउन पहले से Passed परिणाम नहीं बदलता।

रीट्राई

रनर Failed टेस्ट रीट्राई करे तो केवल अंतिम प्रयास रिपोर्ट होता है। ऑटोटेस्ट रीट्राई पर (retry > 0), परिणाम Env टैब में रनर-विशिष्ट कुंजी आती है जैसे PLAYWRIGHT_RETRY या JEST_RETRY (1 दूसरा रन है)। जिन रनर्स में रीट्राई है, उनके पेज पर वह Env कुंजी नाम लिखा होता है।

टिप्पणी, त्रुटियाँ और अटैचमेंट

tracera.comment, tracera.error और tracera.attachment स्टेप के अंदर कॉल करने पर वर्तमान स्टेप में जुड़ते हैं; बाहर — रिज़ल्ट में।

tracera.error केवल एरर टेक्स्ट जोड़ता है — टेस्ट इससे फेल नहीं होता। Failed के लिए रनर का fail API उपयोग करें।

अटैचमेंट सीमाएँ

सीमामान
प्रति स्टेपअधिकतम 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