ब्राउज़र की गड़बड़ी को ठीक करने का तरीका

ब्राउज़र उपलब्ध कराने वाली कंपनियों को उनके ब्राउज़र में मिलने वाली समस्याओं के बारे में बताना, वेब प्लैटफ़ॉर्म को बेहतर बनाने का एक अहम हिस्सा है.

बग की अच्छी रिपोर्ट सबमिट करना, लेकिन इसमें थोड़ा काम करना पड़ता है. आपका लक्ष्य होना चाहिए कि ब्राउज़र इंजीनियर के लिए, गड़बड़ी का पता लगाना, उसकी असल वजह तक पहुंचना, और सबसे ज़रूरी बात, उसे ठीक करने का तरीका ढूंढना जितना हो सके उतना आसान हो. जिन गड़बड़ियों को तेज़ी से ठीक किया जाता है उन्हें आसानी से फिर से जनरेट किया जा सकता है. साथ ही, उनके लिए उम्मीद के मुताबिक व्यवहार साफ़ तौर पर दिखता है.

पुष्टि करना कि यह एक गड़बड़ी है

सबसे पहले, यह पता लगाना होगा कि "सही" व्यवहार क्या होना चाहिए.

सही व्यवहार क्या है?

MDN पर एपीआई से जुड़े दस्तावेज़ देखें या इससे जुड़ी खास जानकारी ढूंढने की कोशिश करें. इस जानकारी से आपको यह तय करने में मदद मिल सकती है कि कौनसा एपीआई असल में काम नहीं कर रहा है, वह कहां काम नहीं कर रहा है, और उससे किस तरह के व्यवहार की उम्मीद की जा रही है.

क्या यह किसी दूसरे ब्राउज़र में काम करता है?

अलग-अलग ब्राउज़र पर अलग-अलग तरह से काम करने वाले व्यवहार को आम तौर पर, इंटरऑपरेबिलिटी की समस्या के तौर पर ज़्यादा प्राथमिकता दी जाती है. खास तौर पर, तब जब बग वाला ब्राउज़र सबसे अलग हो. Chrome, Firefox, Safari, और Edge के नए वर्शन पर टेस्ट करें. इसके लिए, BrowserStack जैसे टूल का इस्तेमाल किया जा सकता है.

अगर हो सके, तो देखें कि उपयोगकर्ता एजेंट स्निफ़िंग की वजह से, पेज जान-बूझकर अलग तरह से काम तो नहीं कर रहा है. Chrome DevTools में, User-Agent स्ट्रिंग को किसी दूसरे ब्राउज़र पर सेट करके देखें.

क्या यह हाल ही में रिलीज़ हुए वर्शन में काम नहीं कर रहा है?

क्या यह सुविधा पहले उम्मीद के मुताबिक काम करती थी, लेकिन ब्राउज़र के हाल ही के रिलीज़ में काम करना बंद कर दिया? इस तरह की समस्याओं को बहुत तेज़ी से ठीक किया जा सकता है. खास तौर पर, तब जब आपने उस वर्शन का नंबर दिया हो जिसमें यह सुविधा काम कर रही थी और उस वर्शन का नंबर दिया हो जिसमें यह सुविधा काम नहीं कर रही थी. ब्राउज़र के पुराने वर्शन की जांच करने के लिए, BrowserStack जैसे टूल इस्तेमाल किए जा सकते हैं. बदलाव को खोजने के लिए, bisect-builds टूल (Chromium के लिए) जैसे टूल इस्तेमाल करें.

अगर कोई समस्या रिग्रेशन है और उसे फिर से जनरेट किया जा सकता है, तो आम तौर पर उसकी असल वजह का पता लगाया जा सकता है और उसे तुरंत ठीक किया जा सकता है.

क्या अन्य लोगों को भी यही समस्या आ रही है?

अगर आपको समस्याएं आ रही हैं, तो हो सकता है कि अन्य डेवलपर को भी समस्याएं आ रही हों. सबसे पहले, Stack Overflow पर गड़बड़ी को खोजने की कोशिश करें. इससे आपको किसी समस्या को किसी खास एपीआई से जोड़ने में मदद मिल सकती है. साथ ही, बग ठीक होने तक समस्या को हल करने का कोई छोटा तरीका ढूंढने में मदद मिल सकती है.

क्या इसकी शिकायत पहले की गई है?

बग के बारे में पता चलने के बाद, यह देखें कि क्या किसी ने पहले ही इसकी शिकायत की है. इसके लिए, ब्राउज़र के बग डेटाबेस में खोजें.

अगर आपको कोई ऐसी गड़बड़ी मिलती है जो आपकी समस्या के बारे में बताती है, तो गड़बड़ी को स्टार का निशान लगाकर, उसे पसंदीदा के तौर पर जोड़कर या उस पर टिप्पणी करके अपना समर्थन दें. कई साइटों पर, खुद को सीसी सूची में जोड़ा जा सकता है. इससे बग में बदलाव होने पर आपको अपडेट मिलेंगे.

अगर आपको गड़बड़ी पर टिप्पणी करनी है, तो इस बारे में जानकारी शामिल करें कि गड़बड़ी से आपकी वेबसाइट पर क्या असर पड़ता है. "+1" स्टाइल वाली टिप्पणियां जोड़ने से बचें, क्योंकि बग ट्रैकर आम तौर पर हर टिप्पणी के लिए ईमेल भेजते हैं.

गड़बड़ी की शिकायत करना

अगर गड़बड़ी की शिकायत पहले नहीं की गई है, तो ब्राउज़र वेंडर को इसके बारे में बताएं.

एक छोटा टेस्ट केस बनाएं

Mozilla ने कम से कम टेस्ट केस बनाने के तरीके के बारे में एक बेहतरीन लेख लिखा है. कम शब्दों में कहें, तो समस्या के बारे में बताना एक अच्छी शुरुआत है. हालांकि, बग में समस्या दिखाने वाले डेमो का लिंक देने से बेहतर कुछ नहीं है. तेज़ी से समस्या हल करने के लिए, उदाहरण में कम से कम कोड शामिल होना चाहिए, ताकि समस्या को आसानी से समझा जा सके. बग को ठीक करने की संभावना बढ़ाने के लिए, सबसे पहले आपको एक छोटा कोड सैंपल देना होगा.

टेस्ट केस को छोटा करने के लिए, यहां कुछ सुझाव दिए गए हैं:

  • वेब पेज डाउनलोड करें, <base href="https://original.url"> जोड़ें और पुष्टि करें कि गड़बड़ी स्थानीय तौर पर मौजूद है. अगर यूआरएल में एचटीटीपीएस का इस्तेमाल किया जाता है, तो इसके लिए लाइव एचटीटीपीएस सर्वर की ज़रूरत पड़ सकती है.
  • ज़्यादा से ज़्यादा ब्राउज़र के नए बिल्ड पर, लोकल फ़ाइलों की जांच करें.
  • सभी जानकारी को एक ही फ़ाइल में शामिल करने की कोशिश करें.
  • कोड को तब तक हटाएं, जब तक गड़बड़ी ठीक न हो जाए. सबसे पहले, उन चीज़ों को हटाएं जिनकी ज़रूरत नहीं है.
  • वर्शन कंट्रोल का इस्तेमाल करें, ताकि आप अपना काम सेव कर सकें और गलतियों को पहले जैसा कर सकें.

एक छोटा टेस्ट केस होस्ट करें

अगर आपको अपने छोटे किए गए टेस्ट केस को होस्ट करने के लिए कोई अच्छी जगह चाहिए, तो यहां कुछ अच्छी जगहें उपलब्ध हैं:

ध्यान रखें कि इनमें से कई साइटें, iframe में कॉन्टेंट दिखाती हैं. इसकी वजह से, सुविधाओं या गड़बड़ियों का व्यवहार अलग हो सकता है.

अपनी समस्या की शिकायत करें

मिनिमाइज़ किया गया टेस्ट केस मिलने के बाद, उस गड़बड़ी की शिकायत की जा सकती है. बग ट्रैक करने वाली सही साइट पर जाएं और नई समस्या बनाएं.

गड़बड़ी की साफ़ तौर पर जानकारी दें और उसे दोहराने के तरीके बताएं

सबसे पहले, समस्या के बारे में साफ़ तौर पर बताएं, ताकि इंजीनियरों को समस्या को तुरंत समझने और उसे हल करने में मदद मिल सके.

When installing a PWA using the `beforeinstallprompt.prompt()`, the
`appinstalled` event fires before the call to `prompt()` resolves.

इसके बाद, समस्या को फिर से ट्रिगर करने के लिए ज़रूरी चरणों की जानकारी दें. साथ ही, उम्मीद के मुताबिक और असल नतीजे के बारे में बताएं.

What is the expected result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)
2. INSTALL: Success (logged when `appinstalled` event fired)

What is the actual result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL: Success (logged when `appinstalled` event fired)
2. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)

ज़्यादा जानकारी के लिए, एमडीएन पर गड़बड़ी की रिपोर्ट लिखने के दिशा-निर्देश देखें.

बोनस: समस्या का स्क्रीनशॉट या स्क्रीनकास्ट जोड़ें

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

सिस्टम की जानकारी शामिल करें

कुछ गड़बड़ियां सिर्फ़ कुछ ऑपरेटिंग सिस्टम या खास तरह के डिसप्ले पर ही दिखती हैं. उदाहरण के लिए, कम डीपीआई या ज़्यादा डीपीआई वाले डिसप्ले. आपने जिन टेस्ट एनवायरमेंट का इस्तेमाल किया है उनकी जानकारी ज़रूर शामिल करें.

गड़बड़ी की शिकायत सबमिट करें

आखिर में, गड़बड़ी की शिकायत सबमिट करें. बग से जुड़े जवाबों के लिए, अपने ईमेल पर नज़र रखें. आम तौर पर, जांच के दौरान इंजीनियर आपसे कुछ और सवाल पूछ सकते हैं. अगर उन्हें समस्या को फिर से पैदा करने में मुश्किल होती है, तो वे आपसे संपर्क कर सकते हैं.