ऑटोटेस्ट एडेप्टर
आधिकारिक एडेप्टर से ऑटोमेटेड टेस्ट को Tracera केस से बाँधें और परिणाम अपलोड करें।
शुरू करने से पहले
- इंस्टेंस URL (
TRACERA_BASE_URL)। - प्रोजेक्ट Autotest टोकन (
TRACERA_AUTOTEST_TOKEN) — प्रोजेक्ट सेटिंग्स → Autotest (देखें टोकन)। - प्रोजेक्ट id (
TRACERA_PROJECT_ID)। - केस कार्ड से टेस्ट केस 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
Swift: Swift Testing, XCUITest