Playwright Logbook के साथ अपने टेस्टिंग वर्कफ़्लो को बेहतर बनाना

एक लाल टेस्ट परिणाम निराशाजनक हो सकता है। यह अक्सर कई सवाल खड़े करता है: कौन सा प्रयास विफल हुआ? वास्तव में एसरशन क्या कह रहा था? क्या यह टेस्ट पहले के रन में भी विफल हो रहा था? आप इस जानकारी को अपने साथियों या कोडिंग सहायक के साथ कैसे साझा कर सकते हैं?

यह लेख एक ऐसे टूल के बारे में विस्तार से बताता है जो इन चिंताओं को दूर करता है: Playwright Logbook। यह ओपन-सोर्स रिपोर्टर टेस्टिंग के लिए Playwright का उपयोग करते समय आपकी डीबगिंग और सहयोग प्रक्रियाओं को बेहतर बनाने के लिए डिज़ाइन किया गया है। जैसे-जैसे सॉफ्टवेयर डेवलपमेंट लगातार विकसित हो रहा है, वर्कफ़्लो को सुव्यवस्थित करने वाले टूल्स का होना पहले से कहीं अधिक महत्वपूर्ण है।

Playwright Logbook क्या है?

Playwright Logbook एक रिपोर्टर है जो आपके टेस्ट रन पर नज़र रखता है, और विफलताओं, रीट्राई तथा समय के साथ हुए परिवर्तनों के बारे में मूल्यवान जानकारी कैप्चर करता है। यह इस सभी डेटा को एक एकल स्थानीय HTML रिपोर्ट में समेकित करता है, जिससे डेवलपर्स के लिए इनसाइट्स का विश्लेषण करना और उन्हें साझा करना आसान हो जाता है।

मुख्य विशेषताएं

• व्यापक विफलता डायग्नोस्टिक्स: Logbook त्रुटि संदेशों और स्टैक ट्रेस सहित टेस्ट विफलताओं के बारे में विस्तृत जानकारी कैप्चर करता है।
• रीट्राई ट्रैकिंग: यह टेस्ट रीट्राई की निगरानी और उन्हें रिकॉर्ड करता है, जिससे आपको टेस्ट की स्थिरता को समझने में मदद मिलती है।
• रन-टू-रन इतिहास: Logbook टेस्ट रन का इतिहास बनाए रखता है, जिससे आप परिवर्तनों को ट्रैक कर सकते हैं और पैटर्न की पहचान कर सकते हैं।
• फोकस्ड डीबगिंग पैकेट्स: कमांड-लाइन इंटरफ़ेस (CLI) विशिष्ट टेस्ट के लिए प्रासंगिक साक्ष्य युक्त संक्षिप्त पैकेट जनरेट कर सकता है।

Playwright Logbook को कैसे इंस्टॉल और उपयोग करें

चरण 1: रिपोर्टर इंस्टॉल करें

शुरुआत करने के लिए, आपको अपने प्रोजेक्ट में Playwright Logbook इंस्टॉल करना होगा। अपने टर्मिनल में निम्नलिखित कमांड चलाएँ:

npm install --save-dev playwright-logbook

चरण 2: Playwright को कॉन्फ़िगर करें

इसके बाद, आपको रिपोर्टर को अपनी playwright.config.ts फ़ाइल में सेट अप करना होगा। यहाँ बताया गया है कि कैसे:

import { defineConfig } from '@playwright/test';

export default defineConfig({
  reporter: [
    ['list'],
    // Opt-in: capture steps, output tails, and eligible image previews.
    ['playwright-logbook', { captureDetails: true }],
  ],
  use: {
    screenshot: 'only-on-failure',
    trace: 'on-first-retry',
  },
});

यह captureDetails विकल्प अतिरिक्त डायग्नोस्टिक्स की अनुमति देता है। यह trace: 'on-first-retry' सेटिंग केवल तभी ट्रेस कैप्चर करती है जब पहला रीट्राई होता है।

चरण 3: अपने टेस्ट चलाएँ

अब, आप Playwright के टेस्ट रनर का उपयोग करके अपने टेस्ट चला सकते हैं:

npx playwright test

चरण 4: रिपोर्ट एक्सेस करें

टेस्ट चलाने के बाद, आप अपने ब्राउज़र में निम्नलिखित फ़ाइल खोलकर जनरेट की गई रिपोर्ट देख सकते हैं:

.logbook/report/index.html

इस फ़ाइल को सर्वर की आवश्यकता के बिना स्थानीय रूप से एक्सेस किया जा सकता है।

डीबगिंग के लिए CLI का उपयोग करना

फोकस्ड डीबगिंग के लिए, Logbook का CLI आपको विशिष्ट टेस्ट के लिए रिकॉर्ड किए गए साक्ष्य वाले पैकेट जनरेट करने की अनुमति देता है। यहाँ कुछ उपयोगी कमांड दिए गए हैं:

npx playwright-logbook history --limit 10 --json
npx playwright-logbook summary --run latest --format json
npx playwright-logbook debug --run latest --test YOUR_TEST_ID --format json

सुनिश्चित करें कि आप YOUR_TEST_ID को उस विशिष्ट टेस्ट आइडेंटिफ़ायर से बदलें जिसकी आप जांच करना चाहते हैं।

टेस्ट विफलताओं की जांच करना

जब कोई टेस्ट विफल होता है, तो Logbook आपको समस्या की गहराई से जांच करने में मदद करता है। आप स्टेटस, प्रोजेक्ट और टैग के आधार पर परिणामों को फ़िल्टर कर सकते हैं। यह आपको रीट्राई से पहले क्या विफल हुआ था, इसके विवरण के साथ-साथ रिकॉर्ड की गई त्रुटियों और स्टैक ट्रेस को देखने की अनुमति देता है।

Failures टैब समान रिकॉर्ड की गई त्रुटियों को समूहित करता है, जिससे आपको नई विफलताओं, ठीक किए गए टेस्ट और अभी भी विफल हो रहे टेस्ट की पहचान करने में मदद मिलती है। यह जानकारी आपकी डीबगिंग प्रक्रिया का मार्गदर्शन कर सकती है।

निष्कर्ष

Playwright Logbook एक शक्तिशाली टूल है जो आपके टेस्टिंग वर्कफ़्लो को बेहतर बनाता है। यह आपके टेस्ट रन के बारे में विस्तृत इनसाइट्स प्रदान करता है, जिससे आपको और आपकी टीम को समस्याओं का अधिक प्रभावी ढंग से निदान करने में मदद मिलती है।

लाभ

• विफलता डायग्नोस्टिक्स को एक एकल रिपोर्ट में समेकित करता है।
• बेहतर इनसाइट्स के लिए रीट्राई और रन इतिहास को ट्रैक करता है।
• कोडिंग सहायकों के साथ आसान संचार की सुविधा प्रदान करता है।
• विशिष्ट टेस्ट के लिए फोकस्ड डीबगिंग पैकेट्स प्रदान करता है।

कमियां

• इंस्टॉलेशन और कॉन्फ़िगरेशन की आवश्यकता होती है।
• CI इंटीग्रेशन के लिए मैन्युअल वर्कफ़्लो की आवश्यकता हो सकती है।
• यह टेस्ट को स्वचालित रूप से ठीक नहीं करता है और न ही AI प्रदाताओं को कॉल करता है।

सावधानी

यह लेख शैक्षणिक उद्देश्यों के लिए है। प्लेसहोल्डर मानों को अपने वास्तविक प्रोजेक्ट विवरण से बदलना याद रखें। किसी भी दावे पर भरोसा करने से पहले हमेशा मूल स्रोत से उसकी पुष्टि करें।

अक्सर पूछे जाने वाले सवाल

• Playwright Logbook क्या है? — यह एक ओपन-सोर्स रिपोर्टर है जो टेस्ट रन को ट्रैक करता है और विस्तृत विफलता डायग्नोस्टिक्स प्रदान करता है।
• मैं Playwright Logbook कैसे इंस्टॉल करूँ? — आप npm का उपयोग करके इस कमांड के साथ इसे इंस्टॉल कर सकते हैं: npm install --save-dev playwright-logbook.
• Playwright Logbook कौन सी सुविधाएं प्रदान करता है? — यह व्यापक विफलता डायग्नोस्टिक्स, रीट्राई ट्रैकिंग, रन इतिहास और फोकस्ड डीबगिंग पैकेट्स प्रदान करता है।
• मैं Logbook द्वारा जनरेट की गई रिपोर्ट कैसे देख सकता हूँ? — आप इस स्थान पर मौजूद रिपोर्ट को .logbook/report/index.html अपने ब्राउज़र में खोल सकते हैं।
• क्या मैं CI/CD टूल्स के साथ Logbook का उपयोग कर सकता हूँ? — हाँ, लेकिन इंटीग्रेशन के लिए आपको मैन्युअल वर्कफ़्लो का पालन करने की आवश्यकता हो सकती है।
• क्या Logbook स्वचालित रूप से टेस्ट विफलताओं को ठीक करता है? — नहीं, Logbook AI प्रदाताओं को कॉल नहीं करता है या टेस्ट को स्वचालित रूप से ठीक नहीं करता है।

टैग

#playwright #testing #opensource #debugging #softwaredevelopment #devtools #automation #programming