ब्राउज़र वेंडर को उनके ब्राउज़र में मिलने वाली समस्याओं के बारे में बताना वेब प्लैटफ़ॉर्म को बेहतर बनाने का एक अहम हिस्सा है!
किसी अच्छे बग को ठीक करना कठिन तो नहीं है, लेकिन थोड़ी सी मेहनत लगती है. इस लक्ष्य का मकसद है कि आसानी से खोज में मदद पाने के लिए, समस्या को कैसे हल किया जा सकता है. तेज़ी से काम करने वाली गड़बड़ियां, संभावित व्यवहार सही नहीं रहेगा.
पुष्टि करें कि यह गड़बड़ी है
सबसे पहले यह पता लगाना है कि "सही" क्या है और व्यवहार ऐसा होना चाहिए.
सही व्यवहार क्या है?
MDN पर काम के एपीआई दस्तावेज़ देखें या जानकारी मिलती है. इस जानकारी से आपको यह तय करने में मदद मिल सकती है कि कौनसा एपीआई असल में इसमें गड़बड़ी है, यह कहां काम नहीं कर रहा, और अनुमानित व्यवहार क्या है.
क्या यह किसी दूसरे ब्राउज़र में काम करता है?
ब्राउज़र के बीच अलग-अलग व्यवहार को आम तौर पर इंटरऑपरेबिलिटी से जुड़ी समस्या, खासकर तब, जब गड़बड़ी वाला ब्राउज़र अजीब सवाल करो. Chrome, Firefox, Safari और एज में, शायद BrowserStack जैसे टूल का इस्तेमाल करके.
अगर हो सके, तो देख लें कि पेज
स्निफ़िंग उपयोगकर्ता एजेंट. Chrome DevTools में, User-Agent स्ट्रिंग सेट करने की कोशिश करें
.
क्या हाल ही में रिलीज़ किए गए वीडियो में यह समस्या आई है?
क्या यह पहले की उम्मीद के मुताबिक काम करता था, लेकिन हाल ही में ब्राउज़र रिलीज़ के दौरान यह काम करना बंद कर देता है? ऐसे "रिग्रेशन" और तेज़ी से कार्रवाई की जा सकती है, खास तौर पर तब, वर्शन संख्या जहां यह काम करता था और वह वर्शन जहां यह सफल नहीं हुआ. इस तरह के टूल BrowserStack की मदद से पुराने ब्राउज़र का पता लगाना आसान हो जाता है ब्राउज़र वर्शन और बाईसेक्ट-बिल्ड टूल (Chromium के लिए) बदलाव को बहुत असरदार तरीके से खोजने की सुविधा देता है.
अगर कोई समस्या रिग्रेशन है और बार-बार दोहराई जा सकती है, तो आम तौर पर इसकी मूल वजह यह हो सकती है आसानी से ढूंढा और ठीक किया जा सकता है.
क्या दूसरे लोगों को भी यही समस्या दिख रही है?
अगर आपको समस्याएं आ रही हैं, तो हो सकता है कि दूसरे डेवलपर को भी समस्याएं आ रही हों. सबसे पहले, Stack Overflow पर गड़बड़ी को खोजें. इससे आपको किसी ऐब्सट्रैक्ट समस्या को, काम न करने वाले एपीआई में अनुवाद करने में मदद मिल सकती है, और यह बग का समाधान होने तक अल्पकालिक समाधान ढूंढने में आपकी सहायता कर सकता है.
क्या इसकी शिकायत पहले की गई है?
एक बार जब आपको बग के बारे में पता चल जाए, तो यह देखने का समय है कि वह बग है या नहीं की रिपोर्ट पहले ही ब्राउज़र बग डेटाबेस में खोजकर की जा चुकी है.
- Chromium पर आधारित ब्राउज़र: https://crbug.com
- Firefox: https://bugzilla.mozilla.org/
- Safari और WebKit पर आधारित ब्राउज़र: https://bugs.webkit.org/
अगर आपको कोई ऐसी गड़बड़ी मिलती है जो समस्या की जानकारी दे रही है, तो सहायता टीम से संपर्क करें बैज पर स्टार का निशान लगाएं, उसे पसंदीदा के तौर पर मार्क करें या उस पर टिप्पणी करें. कई साइटों पर, आप खुद को कॉपी सूची में जोड़ सकते हैं और गड़बड़ी में बदलाव होने पर अपडेट पा सकते हैं.
अगर आपको गड़बड़ी के बारे में टिप्पणी करनी है, तो बताएं कि उस गड़बड़ी को कैसे ठीक किया गया आपकी वेबसाइट पर असर डालता है. "1" जोड़ने से बचें स्टाइल टिप्पणियां, बग ट्रैकर के रूप में आम तौर पर हर टिप्पणी के लिए ईमेल भेजते हैं.
गड़बड़ी की शिकायत करें
अगर गड़बड़ी की शिकायत पहले नहीं की गई थी, तो यह ब्राउज़र वेंडर को बताने का समय है कोई जानकारी नहीं है.
छोटा किया गया टेस्ट केस बनाएं
Mozilla का छोटा टेस्ट केस बनाने का तरीका. किसी एक छोटी कहानी हो, लेकिन समस्या की जानकारी देने का काम बेहतरीन शुरुआत है, लेकिन कुछ भी नहीं बीट वाला टूल शामिल करके, बग में लिंक किया गया डेमो दिखाया जाता है. समस्या. तेज़ी से आगे बढ़ने की संभावना को बढ़ाने के लिए, उदाहरण में समस्या को दिखाने के लिए ज़रूरी कम से कम कोड. मिनिमल कोड सैंपल वह तरीका है जिससे आपकी मौजूदा संभावनाओं को गड़बड़ी ठीक की जा रही है.
टेस्ट केस को छोटा करने के लिए, यहां कुछ सलाह दी गई हैं:
- वेब पेज डाउनलोड करें, जोड़ें
<base href="https://original.url">और पुष्टि करें कि गड़बड़ी स्थानीय तौर पर मौजूद है. इसके लिए लाइव एचटीटीपीएस सर्वर की ज़रूरत पड़ सकती है, अगर यूआरएल, एचटीटीपीएस का इस्तेमाल करता है. - ज़्यादा से ज़्यादा ब्राउज़र के नए बिल्ड पर लोकल फ़ाइलों की जांच करें.
- सब कुछ एक फ़ाइल में शामिल करने की कोशिश करें.
- गड़बड़ी ठीक न होने तक कोड हटाएं (जिन चीज़ों के बारे में आपको पता है कि वे गै़र-ज़रूरी नहीं हैं) चला जाता है.
- वर्शन कंट्रोल का इस्तेमाल करें, ताकि आप अपने काम को सेव कर सकें और पुराने काम को पहले जैसा कर सकें गलत.
छोटा किया गया टेस्ट केस होस्ट करना
अगर आपको छोटा किया गया टेस्ट केस होस्ट करने के लिए अच्छी जगह की तलाश है, तो कई अच्छे स्थान उपलब्ध हैं:
ध्यान रखें कि उनमें से कई साइटें iframe में कॉन्टेंट दिखाती हैं, सुविधाओं या बग के काम करने का तरीका अलग हो सकता है.
समस्या दर्ज करना
छोटा किया गया टेस्ट केस मिलने के बाद, गड़बड़ी की शिकायत की जा सकती है. गड़बड़ी को ट्रैक करने वाली सही साइट पर जाएं और नई समस्या बनाएं.
- Chromium पर आधारित ब्राउज़र - https://crbug.com/new
- Firefox - https://bugzilla.mozilla.org/
- Safari और WebKit पर आधारित ब्राउज़र - https://bugs.webkit.org/
समस्या के बारे में साफ़ तौर पर बताएं. साथ ही, यह भी बताएं कि इस समस्या को हल करने के लिए क्या कदम उठाने होंगे
सबसे पहले, इंजीनियर को साफ़ तौर पर जानकारी दें, ताकि वे तुरंत यह समझ सकें कि समस्या है और उसे प्राथमिकता के हिसाब से निपटाने में मदद मिलती है.
When installing a PWA using the `beforeinstallprompt.prompt()`, the
`appinstalled` event fires before the call to `prompt()` resolves.
इसके बाद, समस्या को विस्तार से समझाने के लिए ज़रूरी चरणों के बारे में बताएं. यहां आपका छोटा किया गया टेस्ट केस लागू होता है.
What steps will reproduce the problem?
1. Go to https://basic-pwa.glitch.me/, open DevTools and look at the
console tab.
2. Click the Install button in the page, you might need to interact with
the page a bit before it becomes enabled.
3. Click Install on the browser modal install confirmation.
और आखिर में, उम्मीद के मुताबिक और असल नतीजे के बारे में बताएं.
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)
ज़्यादा जानकारी के लिए, गड़बड़ी की रिपोर्ट लिखने से जुड़े दिशा-निर्देश देखें का इस्तेमाल किया जाता है.
बोनस: समस्या का स्क्रीनशॉट या स्क्रीनकास्ट जोड़ें
हालांकि यह ज़रूरी नहीं है, लेकिन कुछ मामलों में स्क्रीनशॉट जोड़ना मददगार हो सकता है, या स्क्रीनकास्ट के ज़रिए शेयर किया जा सकता है. यह उन मामलों में खास तौर पर मददगार होता है जहां गड़बड़ियां कुछ अजीब चरणों को पूरा करने की ज़रूरत पड़ सकती है. यह देखने में कि क्या होता है स्क्रीनकास्ट या स्क्रीनशॉट की मदद से अक्सर मदद मिल सकती है.
पर्यावरण की जानकारी शामिल करें
कुछ गड़बड़ियां सिर्फ़ कुछ ऑपरेटिंग सिस्टम पर या सिर्फ़ इन डिवाइसों पर बार-बार जनरेट होती हैं खास तरह के डिसप्ले, जैसे कि लो-डीपीआई या हाई-डीपीआई. कृपया आपके इस्तेमाल किए गए किसी भी टेस्ट एनवायरमेंट की जानकारी शामिल कर सकता है.
गड़बड़ी की जानकारी सबमिट करें
आखिर में, गड़बड़ी के बारे में बताएं. फिर, किसी भी ईमेल के लिए अपने ईमेल पर नज़र रखना न भूलें दिखाई गई है. आम तौर पर, जांच के दौरान और गड़बड़ी को ठीक करते समय, इंजीनियर से कुछ और सवाल हो सकते हैं या उन्हें कोई कठिनाई हो सकती है समस्या हल करते समय, वे आपसे संपर्क कर सकते हैं.