एक्सटेंशन काम नहीं कर रहा: लॉग कहाँ मिलेंगे, एरर कैसे पढ़ें
आपने पहला Chrome एक्सटेंशन: 15 मिनट में Hello World का पालन करके बना लिया था, इस बार कुछ नए फीचर जोड़े, नतीजा: आइकॉन पर क्लिक करने पर popup नहीं खुलता या खाली दिखता है, console.log लिखा लेकिन कहीं नहीं दिख रहा, फीचर कभी काम करता है कभी नहीं, fetch से बाहरी API का रिक्वेस्ट बार-बार फेल। पहले जल्दी में कोड बदलने की ज़रूरत नहीं — Chrome एक्सटेंशन डिबगिंग का पहला पाठ: लॉग सही जगह खोजें, एरर से जानकारी निकालें।
सीखने के बाद आप क्या कर सकेंगे
- 60 सेकंड में दो तरह की समस्याओं में फ़र्क़ करें: 'लोड नहीं हुआ' (लोड के समय एरर डायलॉग आता है) और 'लोड हुआ लेकिन एरर है' (Errors बटन लाल हो जाता है)
- एक ही बार में Service Worker, popup और content script — तीन हिस्सों के कोड के लॉग की सही जगह पाएँ, इंटरफ़ेस भर में
console.logखोजते न घूमें - Chrome एक्सटेंशन के 6 हाई-फ्रीक्वेंसी एरर के मूल संदेश जानें, हर एक का कारण और समाधान पता होगा
- एरर का मूल संदेश वैसे ही AI को दें; दो राउंड स्व-जाँच के बाद भी हल न मिले तो तीन चीज़ों के साथ मदद माँगें
⏳ पहली जाँच: 60 सेकंड की तेज़ चेक
एक्सटेंशन मैनेजमेंट पेज खोलें, पहले तय करें कि समस्या किस श्रेणी में आती है:
# 1. एड्रेस बार में टाइप करके एक्सटेंशन मैनेजमेंट पेज खोलें, अपने एक्सटेंशन का कार्ड ढूँढ़ें
chrome://extensions
# 2. लोड के समय एरर डायलॉग आता है → manifest खराब है, एक्सटेंशन लोड नहीं हुआ → 'manifest और परमिशन संबंधी समस्याएँ' देखें
# 3. Errors बटन लाल है → लोड हुआ लेकिन एरर है, खोलकर मूल संदेश कॉपी करें → एरर संदेश के अनुसार सही सेक्शन देखें
# 4. दोनों जगह साफ़ हैं → पक्का करें कि एक्सटेंशन इनेबल है, 'Reload' दबाएँ, फिर से लक्षण दोहराएँ
# 5. अब भी कोई सुराग़ नहीं → संभवतः लॉग गलत जगह देख रहे हैं → 'लॉग कहाँ मिलेंगे' देखकर सही कंसोल चुनकर फिर कोशिश करें🔧 आम समस्याओं की जाँच
नीचे दिए एरर संदेश Chrome के आधिकारिक एक्सटेंशन डिबगिंग ट्यूटोरियल के Broken Color उदाहरण से शब्दशः लिए गए हैं, एक्सटेंशन कंपोनेंट के अनुसार समूहबद्ध हैं, हर एक के साथ कारण और समाधान दिया गया है।
लॉग कहाँ मिलेंगे: Chrome एक्सटेंशन डिबगिंग में पहले सही जगह देखें
'console.log लिखा, लेकिन कहीं भी आउटपुट नहीं दिख रहा'
कारण: एक्सटेंशन के तीन हिस्सों के लॉग तीन अलग-अलग जगह छपते हैं, गलत जगह देखी तो एक भी नहीं दिखेगा।
समाधान: सही जगह पहचानें —
| कोड कहाँ है | लॉग कहाँ है | कैसे खोलें |
|---|---|---|
| Service Worker | एक्सटेंशन पेज Inspect views के पास के लिंक से खुलने वाला DevTools | chrome://extensions → एक्सटेंशन कार्ड पर service worker लिंक पर क्लिक करें |
| popup | popup का अपना DevTools | खुले popup पर राइट-क्लिक → 'Inspect' |
| content script | होस्ट वेबपेज का कंसोल | लक्ष्य वेबपेज पर F12, top के पास के ड्रॉपडाउन में अपना एक्सटेंशन चुनें |
आपको यह दिखना चाहिए: हर हिस्से का console.log अपनी सही जगह दिखे। तीन हिस्सों का क्या काम है, यह Content Script और Service Worker: एक्सटेंशन का दिमाग़ और हाथ-पैर में देखें।
💡 एक्सटेंशन के अन्य फुल-पेज पेज
टैब के रूप में दिखने वाले एक्सटेंशन पेज (जैसे फुल-पेज ऑप्शंस पेज) पर सीधे राइट-क्लिक 'Inspect' करके लॉग देखें, या एक्सटेंशन मैनेजमेंट पेज पर जाकर Errors देखें।
'फीचर कभी काम करता है कभी नहीं, service worker सोया हुआ लगता है'
कारण: ज़रूरी नहीं कि भ्रम हो।Inspect (DevTools खोलने) के दौरान service worker लगातार एक्टिव रहता है, कई 'सोने के बाद ही सामने आने वाली' समस्याएँ तब दोहराई नहीं जा पातीं; DevTools बंद होते ही वह अपने सामान्य लाइफसाइकल के अनुसार बंद होता है।
समाधान:
- समस्या दोहराते समय DevTools खुला रखें (Inspect views के लिंक से), ताकि worker बीच में न सोए।
- असली व्यवहार की जाँच में DevTools बंद करें, ताकि worker सामान्य लाइफसाइकल के अनुसार बंद हो।
- मैन्युअल रूप से शुरू/बंद करना चाहते हैं: एक्सटेंशन पेज पर Inspect views के ऊपर दिख रही एक्सटेंशन ID कॉपी करें, ब्राउज़र में
chrome-extension://<你的扩展ID>/manifest.jsonखोलें, उस पेज को इंस्पेक्ट करके Application पैनल के Service Workers फ़्रेम में जाएँ, और status के बगल के लिंक से शुरू/बंद करें।
manifest और अनुमतियों से जुड़ी समस्याएँ
「Failed to load extension / Required value version is missing or invalid. It must be between 1-4 dot-separated integers each between 0 and 65536. / Could not load manifest.」
कारण: manifest.json के फ़ील्ड का नाम या फ़ॉर्मैट ग़लत है—जैसे "version" को "versions" लिख दिया, एक्सटेंशन लोड ही नहीं हुआ। यह एरर डायलॉग लोड करते समय पॉप अप होता है, और Chrome समस्या कहाँ है वह बता देता है।
समाधान:
- डायलॉग में नाम लिए गए फ़ील्ड के हिसाब से manifest.json जाँचें और सही रूप में ठीक करें (
versions→version)। - सेव करने के बाद
chrome://extensionsपर लौटकर「重新加载」(Reload) पर क्लिक करें। - आपको यह दिखना चाहिए: डायलॉग अब पॉप अप नहीं होता, एक्सटेंशन कार्ड सामान्य रूप से दिखता है।
- बार-बार ठीक न हो, तो पूरी एरर मैसेज जस की तस AI को कॉपी करके दें, साथ में manifest.json का पूरा टेक्स्ट जोड़ें।
💡 ऐसी ग़लतियाँ पहले से रोकें
कोड एडिटर में manifest.json पर Chrome manifest का JSON schema (json.schemastore.org/chrome-manifest) लगा दें—फ़ील्ड की स्पेलिंग ग़लत हो या ज़रूरी फ़ील्ड छूट जाए, तो वह तुरंत लाल हो जाएगा।
「Permission 'activetab' is unknown or URL pattern is malformed.」
कारण: अनुमति का नाम ग़लत स्पेल है, जैसे activeTab को पूरा लोअरकेस activetab लिख दिया। ध्यान दें: ऐसी ग़लती में एक्सटेंशन फिर भी सफलतापूर्वक लोड हो जाता है, बस एक्सटेंशन पेज का Errors बटन लाल हो जाता है, इसलिए इसे सबसे ज़्यादा नज़रअंदाज़ किया जाता है।
समाधान:
chrome://extensionsखोलें, और एक्सटेंशन कार्ड पर लाल हुए Errors बटन पर क्लिक करें।- एरर में नाम ली गई अनुमति की स्पेलिंग ठीक करें:
activetab→activeTab। - ऊपर दाएँ कोने का Clear all दबाकर पुराने लॉग हटाएँ, फिर एक्सटेंशन दोबारा लोड करें।
- आपको यह दिखना चाहिए: Errors बटन अब लाल नहीं होता।
「fetch() से बाहरी API का अनुरोध बार-बार विफल होना」
कारण: manifest में टारगेट URL को host permission घोषित नहीं किया गया। fetch() से बाहरी सर्वर को कॉल करने के लिए पहले manifest में वह URL घोषित करना ज़रूरी है, वरना रिक्वेस्ट भेजी ही नहीं जा सकती—वही कोड सामान्य वेबपेज में चल जाता है, फ़र्क़ बस यही है।
समाधान:
- manifest में टारगेट साइट को host permission के रूप में घोषित करें।
- सेव करने के बाद एक्सटेंशन दोबारा लोड करें, फिर एक बार रिक्वेस्ट भेजें।
- आपको यह दिखना चाहिए: रिक्वेस्ट popup के Network पैनल में दिखती है (पकड़ने का तरीका「popup से जुड़ी समस्याएँ」सेक्शन में देखें)।
Service Worker से जुड़ी समस्याएँ
「Service worker registration failed. Status code: 15.」
कारण: service worker शुरुआत (रजिस्ट्रेशन) चरण में ही एरर फेंक देता है, जैसे onInstalled को लोअरकेस oninstalled लिख दिया। रजिस्ट्रेशन विफल रहने के दौरान worker का DevTools तक नहीं खुलता, इसलिए पहले यह ठीक करना ज़रूरी है।
समाधान:
chrome://extensionsपर लौटकर Errors पर क्लिक करें—सबसे पहले दिखने वाली यही रजिस्ट्रेशन विफलता है।- असली कारण आमतौर पर उसके तुरंत बाद आने वाली दूसरी एरर में होता है (अगला सेक्शन देखें), उसी के हिसाब से कोड ठीक करें।
- ठीक करने के बाद Clear all दबाएँ और दोबारा लोड करें। आपको यह दिखना चाहिए: Errors में यह एरर अब नहीं आती।
「Uncaught TypeError: Cannot read properties of undefined (reading 'addListener')」
कारण: undefined ऑब्जेक्ट पर addListener कॉल किया गया—दस में नौ बार API का नाम ग़लत स्पेल होता है (जैसे onInstalled को oninstalled लिख दिया), ऑब्जेक्ट मिलता ही नहीं और उसके बाद का कॉल क्रैश हो जाता है।
समाधान:
- एरर में दी गई लाइन नंबर पर API नाम की स्पेलिंग और केस जाँचें, सही नाम में ठीक करें।
- एक्सटेंशन दोबारा लोड करें, Inspect views से DevTools खोलकर पक्का करें कि worker सामान्य रूप से रजिस्टर हुआ है।
- आपको यह दिखना चाहिए: worker के Console में आपके लिखे लॉग छपते हैं, एरर नहीं आती।
popup से जुड़ी समस्याएँ
「Uncaught ReferenceError: tabs is not defined」
कारण: popup कोड में बिना परिभाषित tabs इस्तेमाल हुआ (जैसे tabs.query वाला हिस्सा कमेंट कर दिया गया), एक्सटेंशन को पता ही नहीं कि स्क्रिप्ट किस टैब में इंजेक्ट करनी है।
समाधान:
- खुले popup पर राइट-क्लिक →「检查」(Inspect) करके popup का अपना DevTools खोलें, एरर Console में ही है।
tabs.queryजोड़कर मौजूदा टैब लें, फिरtabs[0].idसे इंजेक्शन टारगेट तय करें।- Clear all दबाकर दोबारा लोड करें, popup दोबारा खोलकर जाँचें। आपको यह दिखना चाहिए: बटन दबाने पर टारगेट टैब में अपेक्षित असर दिखता है।
「popup के नेटवर्क रिक्वेस्ट में से एक भी नहीं पकड़ा जा पाना」
कारण: popup रिक्वेस्ट बहुत तेज़ भेजता है, अक्सर आपके DevTools खोलने से पहले ही सब भेज चुका होता है, इसलिए Network पैनल खाली दिखता है।
समाधान: popup के DevTools में Network पैनल पर स्विच करें, पैनल में रिफ़्रेश पर क्लिक करें—इससे popup रीलोड होता है पर DevTools बंद नहीं होता, और रिक्वेस्ट रिकॉर्ड हो जाती है।
content script से जुड़ी समस्याएँ
「Uncaught ReferenceError: colors is not defined」
कारण: content script में वेरिएबल का नाम ग़लत स्पेल है (जैसे color को colors लिख दिया), इंजेक्ट की गई स्क्रिप्ट वेरिएबल सही से पास नहीं कर पाई।
समाधान:
- होस्ट वेबपेज पर जाकर F12 दबाकर कंसोल खोलें—content script की एरर यहीं छपती है, एक्सटेंशन पेज पर नहीं।
- कंसोल में top के बगल का ड्रॉपडाउन तीर खोलकर अपना एक्सटेंशन चुनें, ताकि सिर्फ़ उसके लॉग दिखें।
- एरर के हिसाब से सही वेरिएबल नाम वापस लिखें, वेबपेज रिफ़्रेश करके दोबारा कोशिश करें। आपको यह दिखना चाहिए: वेबपेज कंसोल से एरर ग़ायब हो जाती है, पेज पर असर दिखता है।
「एक्सटेंशन पेज के Errors बिल्कुल साफ़ होने के बावजूद प्लगइन काम न करना」
कारण: एक्सटेंशन पेज का Errors सिर्फ़ रनटाइम एरर, console.warning और console.error रिकॉर्ड करता है। content script की कई समस्याएँ वहाँ दिखती ही नहीं—लॉग की जगह ग़लत देखी, तो कितना भी खोजो बेकार है।
समाधान:
- होस्ट वेबपेज के कंसोल में जाकर दोबारा जाँचें (तरीका पिछली बात में देखें)।
- लॉग सच में साफ़ हैं, manifest को schema से भी जाँच लिया है, फिर भी फ़ीचर काम नहीं कर रहा—आँख बंद करके परखना बंद करें, तीन चीज़ें साथ लेकर मदद के लिए आगे बढ़ें (नीचे देखें)।
💡 फिर भी काम नहीं हो रहा?
दो राउंड स्वयं-जांच के बाद भी कोई सुराग न मिले, तो अंधाधुंध प्रयास करना बंद करें। निम्न में से कोई भी स्थिति दिखे, तो तुरंत एस्केलेट करें:
- एरर Chrome API के व्यवहार से जुड़ा हो, और AI के लगातार दो राउंड में दिए गए सुधार बेअसर हों
- लॉग साफ हों, manifest schema सत्यापन पास हो जाए, फिर भी फीचर काम न करे, और आपने पुष्टि कर ली हो कि लॉग की जगह गलत नहीं देखी
मदद मांगते समय तीन चीज़ें साथ रखें:
- manifest.json का पूरा टेक्स्ट
- पूरा एरर मूल पाठ (स्टैक सहित)
- न्यूनतम पुनरुत्पादन कदम
सामग्री पूरी हो, तो AI को भेजें या प्रश्न पूछने जाएं — पहले ही राउंड में प्रभावी उत्तर मिलेगा। एरर को जस-का-तस AI को वापस देने का ठोस तरीका देखें एरर लूप: एरर संदेश को जस-का-तस वापस खिलाएं।
संक्षेप में, chrome एक्सटेंशन डिबगिंग का रास्ता बस 3 कदमों का है: पहले वर्गीकृत करें, फिर लॉग की सही जगह ढूंढें, और अंत में एरर का मूल पाठ जस-का-तस वापस खिलाएं।
अगले पाठ की झलक
एक्सटेंशन स्थिर रूप से चलने लगे, तो इसे और लोगों के साथ साझा करें: अगले पेज पर Chrome वेब स्टोर पर प्रकाशित करना: पंजीकरण, पैकेजिंग और समीक्षा जमा करने की पूरी प्रक्रिया, डेवलपर खाता पंजीकृत करने, पैकेजिंग और समीक्षा जमा करने की पूरी प्रक्रिया आपके साथ पूरी करेंगे।