पहला Chrome प्लगइन: 15 मिनट में Hello World चलाएँ
💡 एक वाक्य में सारांश: एक फ़ोल्डर, तीन फ़ाइलें, Chrome डेवलपर मोड——15 मिनट, और ब्राउज़र आपके अपने प्लगइन का Hello World दिखाएगा।
पिछले पाठ C1 ब्राउज़र प्लगइन क्या है में अवधारणाएँ पूरी हो गईं: प्लगइन बस HTML/CSS/JS और एक manifest.json है।इस पाठ में हाथ से करें——chrome प्लगइन शुरुआत का सबसे मज़बूत चरण, दस और शब्द रटना नहीं, बल्कि ब्राउज़र में आपका अपना प्लगइन सच में पॉपअप कराना।
इन 15 मिनटों को न छोड़ें——भले ही आप पूरा कोड AI से लिखवाने का इरादा रखते हों।लोकल लोड, रीफ्रेश, पॉपअप देखना ये तीन काम हमेशा आपको खुद करने होंगे, Hello World इन्हें मसल मेमोरी बनाने का अभ्यास है।
सीखने के बाद आप क्या कर सकेंगे
- एक ऐसा प्लगइन बनाएँ जो सच में Chrome में इंस्टॉल हो: टूलबार आइकन पर क्लिक करें, "Hello Extensions" पॉपअप हो
- manifest.json का आधिकारिक न्यूनतम उदाहरण अक्षर-दर-अक्षर लिखें, बताएँ कि हर फ़ील्ड क्या करती है
chrome://extensions→ डेवलपर मोड → Load unpacked तीन चरणों में लोकल लोड पूरा करें- प्लगइन को टूलबार पर Pin करें, कभी भी क्लिक करके उपयोग करें
- रीलोड नियम याद रखें: किन फ़ाइलों के बदलाव पर प्लगइन रीफ्रेश करना होता है, किन पर नहीं
आपकी अभी की दिक्कत
- "प्लगइन के शब्द ढेर सारे रटे: manifest, MV3, popup……लेकिन एक भी लाइन कोड ब्राउज़र में नहीं चला"
- "AI ने कोड लिख दिया, पर ये फ़ाइलें कहाँ रखें, Chrome उन्हें कैसे पहचानेगा, मुझे नहीं पता"
- "नेट पर पुराने ट्यूटोरियल से कॉपी किया, Load unpacked पर क्लिक करते ही एरर, पता नहीं गलती कहाँ"
इस तरकीब का उपयोग कब करें
जब आपको चाहिए:
- "एक प्लगइन बनाना" विचार से वास्तविकता बनाना——पहले सबसे छोटा चलाएँ, फिर फ़ीचर जोड़ें
- डेवलपमेंट चेन की जाँच: फ़ाइल बन सके, लोड हो सके, पॉपअप दिखे, तीनों चरण पार
- AI की ज़रूरतों को एक ठोस शुरुआत देना: पहले Hello World चलाएँ, अगले पाठ में AI से ऊपर निर्माण कराएँ
और नहीं चाहते:
- शुरू में ही manifest की सारी फ़ील्ड चबाना——अगले पाठ C3 में एक-एक करके समझेंगे
- पैकेजिंग, स्टोर पर अपलोड, समीक्षा छेड़ना——वह C6 का काम है
- कोई डेवलपमेंट एनवायरनमेंट इंस्टॉल करना——एक फ़ोल्डर + Chrome का अंतर्निहित डेवलपर मोड काफ़ी है
🎒 शुरू करने से पहले की तैयारी
- C1 ब्राउज़र प्लगइन क्या है पूरा करें, जानें कि प्लगइन = HTML/CSS/JS + manifest.json, अभी केवल MV3 लिखें
- कंप्यूटर पर Chrome ब्राउज़र इंस्टॉल हो
- एक टेक्स्ट फ़ाइल बनाने-संपादित करने का टूल (सिस्टम का नोटपैड चलेगा; VS Code जैसा कोड एडिटर ज़्यादा आरामदायक)
- 15 मिनट
मुख्य विचार
एक Chrome प्लगइन का सबसे छोटा रूप बस एक फ़ोल्डर और तीन फ़ाइलें है:
| फ़ाइल | काम | कौन उपयोग करता है |
|---|---|---|
manifest.json | प्लगइन का पहचानपत्र + मैनुअल: नाम क्या, वर्ज़न कितना, आइकन पर क्लिक से क्या हो | Chrome इसे पढ़ता है |
hello.html | टूलबार आइकन पर क्लिक से पॉप होने वाला वह छोटा पेज | उपयोगकर्ता इसे देखता है |
hello_extensions.png | टूलबार आइकन (छोड़ सकते हैं, Chrome सामान्य आइकन दे देगा) | उपयोगकर्ता इसे देखता है |
चलने का सिद्धांत एक वाक्य में: Chrome manifest.json से आपका प्लगइन पहचानता है; manifest में action.default_popup Chrome को बताता है "टूलबार आइकन पर क्लिक होने पर hello.html खोलो"।
हाथ लगाने से पहले दो नियम तय करें:
manifest_versionकेवल 3 लिखें।आधिकारिक रूप से स्पष्ट कहा गया है कि एकमात्र समर्थित मान 3 है; पुराने ट्यूटोरियल का 2 कॉपी न करें (C1 में बताया गया कि MV2 पूरी तरह प्रतिबंधित है, फ़ील्ड नियम C3 विस्तार से)।- डेवलपर मोड ≠ स्टोर पर अपलोड।डेवलपर मोड + Load unpacked बस "लोकल फ़ोल्डर को ब्राउज़र में इंस्टॉल करने की अनुमति" का स्विच है; Chrome वेब स्टोर पर अपलोड के लिए डेवलपर पंजीकरण और समीक्षा से गुज़रना होता है, वह अलग रास्ता है (देखें C6)।
💡 इस पाठ में हाथ से टाइप करना है?
तीन फ़ाइलें इतनी कम हैं कि हाथ से टाइप करने में कुछ मिनट लगेंगे, पहली बार खुद टाइप करने की सलाह——इस चरण में एक कोट या एक फ़ील्ड नाम पर सबसे आसानी से अटकते हैं, एक बार हाथ से टाइप करने पर आगे पता चलेगा कि AI का लिखा कहाँ जाँचना है।अगले पाठ से फ़ाइलें बढ़ती जाएँगी, तब AI का मैदान है।
मेरे साथ करें
चरण 1: प्लगइन फ़ोल्डर बनाएँ
क्यों: प्लगइन असल में "एक फ़ोल्डर में कुछ फ़ाइलें" होता है, पहले इन्हें एक घर दें।
कैसे करें: डेस्कटॉप (या किसी भी जगह जहाँ आपको वह मिल सके) पर एक नया फ़ोल्डर बनाएँ और उसका नाम hello-extensions रखें।
अगर आप तैयार उदाहरण से मिलाना चाहते हैं, तो आधिकारिक नमूना सोर्स कोड GitHub पर है: GoogleChrome/chrome-extensions-samples रिपॉज़िटरी के functional-samples/tutorial.hello-world डायरेक्टरी में। लेकिन इस पाठ में अपना खुद का बनाने की सलाह दी जाती है—कुल मिलाकर सिर्फ़ तीन फ़ाइलें हैं।
आपको यह दिखना चाहिए: एक खाली फ़ोल्डर।
चरण 2: manifest.json लिखें—chrome प्लगइन की शुरुआत की पहली फ़ाइल
क्यों: Chrome सिर्फ़ manifest.json को पहचानता है। इसके बिना यह फ़ोल्डर बस एक साधारण फ़ोल्डर ही है।
कैसे करें: फ़ोल्डर में manifest.json नई फ़ाइल बनाएँ, इसकी सामग्री आधिकारिक नमूने से शब्दशः कॉपी करें:
{
"name": "Hello Extensions",
"description": "Base Level Extension",
"version": "1.0",
"manifest_version": 3,
"action": {
"default_popup": "hello.html",
"default_icon": "hello_extensions.png"
}
}छह फ़ील्ड क्या-क्या करते हैं:
| फ़ील्ड | इस पाठ का मान | क्या करता है |
|---|---|---|
name | Hello Extensions | प्लगइन का नाम, एक्सटेंशन पेज जैसी जगहों पर दिखता है |
description | Base Level Extension | एक पंक्ति का विवरण |
version | 1.0 | वर्ज़न नंबर (बिंदु से अलग किए गए 1-4 खंडों के पूर्णांक) |
manifest_version | 3 | MV3 का उपयोग घोषित करता है—एकमात्र समर्थित मान |
action.default_popup | hello.html | टूलबार आइकन पर क्लिक करने पर यह पेज पॉपअप होता है |
action.default_icon | hello_extensions.png | टूलबार आइकन के लिए यह इमेज उपयोग होती है |
⚠️ दो बातें
- JSON मेंकमेंट नहीं लिखे जा सकते—
//और/* */दोनों पार्सिंग को सीधे विफल कर देंगे। नोट लिखना हो तो फ़ाइल के बाहर लिखें। - आइकन तैयार नहीं करना चाहते?
"default_icon"वाली पूरी पंक्ति हटा दें, Chrome अपने आप प्लगइन को एक सामान्य आइकन दे देगा।
आपको यह दिखना चाहिए: फ़ोल्डर में एक manifest.json मौजूद है।
- छोटी जाँच: इसे एडिटर से दोबारा खोलें, पुष्टि करें कि
"manifest_version": 3है और हर कोटेशन जोड़े में है
चरण 3: hello.html लिखें, साथ में एक आइकन
क्यों: default_popup जिस फ़ाइल की ओर इशारा करता है वह वास्तव में मौजूद होनी चाहिए, तभी आइकन पर क्लिक करने पर पॉपअप होने के लिए कुछ होगा।
कैसे करें: hello.html नई फ़ाइल बनाएँ, सामग्री आधिकारिक नमूने से कॉपी करें:
<html>
<body>
<h1>Hello Extensions</h1>
</body>
</html>आइकन के लिए दो में से एक विकल्प:
- तरीका A (आधिकारिक नमूने के अनुसार): आधिकारिक ट्यूटोरियल पेज से नमूना आइकन डाउनलोड करें, नाम बदलकर
hello_extensions.pngकरें और फ़ोल्डर में डालें—फ़ाइल का नामdefault_iconमें लिखे से एक अक्षर भी अलग नहीं होना चाहिए। - तरीका B (ज़्यादा आसान): अगर पिछले चरण में
default_iconहटा दिया है, तो सीधे छोड़ दें, Chrome सामान्य आइकन दे देगा।
आपको यह दिखना चाहिए: फ़ोल्डर में दो-तीन फ़ाइलें: manifest.json, hello.html, और साथ में आइकन (अगर तरीका A चुना है)।
चरण 4: chrome डेवलपर मोड चालू करें, Load unpacked से लोकल लोड करें
क्यों: Chrome डिफ़ॉल्ट रूप से सिर्फ़ स्टोर के प्लगइन ही इंस्टॉल करता है। डेवलपर मोड "लोकल इंस्टॉल की अनुमति" का स्विच है, और Load unpacked आपके फ़ोल्डर को ब्राउज़र में इंस्टॉल करता है।
कैसे करें (आधिकारिक तीन चरण):
- नए टैब के एड्रेस बार में
chrome://extensionsटाइप करके Enter दबाएँ, एक्सटेंशन मैनेजमेंट पेज खुलेगा। दो और रास्ते: टूलबार का पज़ल बटन → Manage Extensions; या Chrome मेनू → More Tools → Extensions। - Developer mode (डेवलपर मोड) स्विच चालू करें।
- Load unpacked पर क्लिक करें, फ़ाइल चुनने के डायलॉग में अपना प्लगइन फ़ोल्डर चुनें।
ध्यान दें: चुने गए फ़ोल्डर में सीधे manifest.json होना चाहिए—आधिकारिक नियम के अनुसार इसे प्लगइन की रूट डायरेक्टरी में होना चाहिए, एक और सबफ़ोल्डर की परत डाली तो Chrome इसे नहीं ढूँढ पाएगा।
आपको यह दिखना चाहिए: एक्सटेंशन पेज की सूची में Hello Extensions दिखता है, संदेश The extension has been successfully installed. (प्लगइन सफलतापूर्वक इंस्टॉल हो गया); आइकन नहीं दिया हो तो Chrome ने अपने आप एक सामान्य आइकन दे दिया है।
- छोटी जाँच: Hello Extensions कार्ड सामान्य रूप से दिख रहा है, कोई त्रुटि डायलॉग पॉपअप नहीं हुआ
चरण 5: Pin करके टूलबार में लगाएँ, अपना पहला पॉपअप खोलें
क्यों: लोकल लोड किया गया प्लगइन डिफ़ॉल्ट रूप से पज़ल मेनू में छिपा रहता है, हर बार एक क्लिक ज़्यादा लगता है; Pin करके निकालना ही आसान है।
कैसे करें: टूलबार का पज़ल बटन दबाएँ, Hello Extensions ढूँढें, इसके बगल के पिन आइकन (Pin) पर क्लिक करके टूलबार में पिन करें। फिर टूलबार पर इस प्लगइन के आइकन पर क्लिक करें।
आपको यह दिखना चाहिए: एक छोटा पॉपअप खुलता है, जिसमें लिखा है Hello Extensions—आपका पहला Chrome प्लगइन चल गया।
चरण 6: कोड बदलें, प्लगइन रीफ्रेश करना सीखें
क्यों: प्लगइन आपकी बदली हुई फ़ाइलें अपने आप नहीं पढ़ता, ज़्यादातर बदलाव मैन्युअल रीफ्रेश के बाद ही लागू होते हैं—नए लोग इसे सबसे ज़्यादा "AI ने गलत लिखा" समझ लेते हैं।
कैसे करें: manifest.json में name को "Hello Extensions of the world!" करें, सेव करें। chrome://extensions पर वापस जाएँ, प्लगइन कार्ड पर on/off स्विच के बगल के रीफ्रेश आइकन पर क्लिक करें।
आपको यह दिखना चाहिए: प्लगइन का नाम Hello Extensions of the world! हो जाता है। रीफ्रेश न दबाएँ तो वह पुराना नाम ही रहेगा।
आधिकारिक रीलोड नियम तालिका, इसे अभी याद कर लें:
| क्या बदला | प्लगइन रीफ्रेश करना होगा? |
|---|---|
| manifest | हाँ |
| Service worker | हाँ |
| Content scripts | हाँ (साथ ही जिस वेबपेज पर है उसे भी रीफ्रेश करें) |
| पॉपअप (popup) | नहीं |
| सेटिंग्स पेज (Options page) | नहीं |
| प्लगइन के अन्य HTML पेज | नहीं |
इस पाठ के प्लगइन में केवल manifest और popup दो तरह की फ़ाइलें हैं, और नियम बहुत सरल है: manifest बदलो, एक्सटेंशन पेज पर जाकर refresh दबाओ; hello.html बदलो, तो refresh की ज़रूरत नहीं—— पॉपअप दोबारा खोलो, जो दिखेगा वही नया कंटेंट है।
चेकपॉइंट ✅
chrome://extensionsमें Hello Extensions कार्ड सामान्य रूप से दिख रहा है, कोई एरर नहीं- प्लगइन को टूलबार पर Pin किया गया है, आइकॉन पर क्लिक करने से Hello Extensions पॉपअप होता है
nameबदलने के बाद, एक्सटेंशन पेज पर जाकर refresh आइकॉन दबाया, नाम बदल गया- रीलोड नियम बता सकते हैं: manifest, service worker, content scripts को refresh करना होता है; popup और अन्य HTML को नहीं
- जानते हैं कि Developer mode केवल "लोकल लोडिंग" का स्विच है, स्टोर पर जाने के लिए रजिस्ट्रेशन + रिव्यू करना होता है (C6)
आम गलतियों से बचें
❌ manifest.json में कमेंट लिखना
JSON कमेंट को सपोर्ट नहीं करता। // या /* */ लिखने पर manifest पार्स फेल हो जाता है—— लोकल लोड करते समय सीधे एरर डायलॉग बॉक्स पॉप होता है; ऑफिशियल रूप से भी साफ कहा गया है कि पैकेज अपलोड करते समय JSON में कमेंट होने पर Cannot parse the manifest एरर आता है।
सही तरीका: कमेंट और नोट्स फ़ाइल के बाहर लिखें; फ़ील्ड का मतलब शक हो तो C3 फ़ील्ड क्विक रेफ़रेंस देखें।
❌ पुराने ट्यूटोरियल की अंधाधुंध कॉपी, manifest_version को 2 लिखना
इंटरनेट पर बड़ी संख्या में ट्यूटोरियल MV2 युग के हैं। अब manifest_version का एकमात्र सपोर्टेड मान 3 है, और MV2 प्लगइन्स को Chrome ने पूरी तरह बंद कर दिया है—— अंधाधुंध कॉपी करना बेकार मेहनत है।
सही तरीका: काम शुरू करने से पहले देख लें कि यह लाइन "manifest_version": 3 है या नहीं; MV2 सिखाने वाला ट्यूटोरियल दिखे तो तुरंत बंद कर दें।
❌ कोड बदलकर प्लगइन refresh न करना, और सोचना कि "AI ने गलत लिखा"
manifest, service worker, content scripts बदलने के बाद refresh न करें तो ब्राउज़र में पुराना कोड ही चलता है—— आपको गलतफहमी होगी कि कोड में समस्या है, और आप AI से बिल्कुल सही कोड को बार-बार बदलवाते रहेंगे।
सही तरीका: बदलने के बाद पहले चरण 6 के रीलोड नियम तालिका से जाँच लें: जिन्हें refresh करना है उनके लिए एक्सटेंशन पेज पर refresh आइकॉन दबाएँ, popup बदला हो तो ज़रूरत नहीं। फिर भी सही न हो, तो C5 लॉग देखें।
❌ Developer mode चालू करने को ही "स्टोर पर पहुँच गए" समझना
Developer mode केवल लोकल इंस्टॉल की अनुमति देने वाला स्विच है, इस समय प्लगइन केवल आप ही इस्तेमाल कर सकते हैं। Chrome Web Store पर प्रकाशित करने के लिए डेवलपर रजिस्ट्रेशन (एक बार का रजिस्ट्रेशन शुल्क, राशि डेवलपर डैशबोर्ड के वास्तविक पेमेंट पेज पर दिखाई गई के अनुसार) और रिव्यू ज़रूरी है।
सही तरीका: लोकल पर सफलतापूर्वक चलाने के बाद, C6 प्रकाशन की पूरी प्रक्रिया के अनुसार रजिस्ट्रेशन, पैकेजिंग और सबमिट करें।
एडवांस टिप्स (वैकल्पिक)
🚀 पॉपअप में एक लाइन का लॉग जोड़ें, डिबगिंग से पहले ही परिचय पा लें। hello.html के </body> से पहले एक लाइन <script src="popup.js"></script> जोड़ें, नई फ़ाइल popup.js बनाकर console.log("This is a popup!") लिखें। पॉपअप खोलें → पॉपअप पर राइट-क्लिक → Inspect → Console पैनल, इस लॉग को देख सकते हैं। जानबूझकर कोड गलत लिखें (जैसे एक कोट छूट जाए) तो एक्सटेंशन पेज पर Errors बटन दिखेगा, क्लिक करके विवरण देखें। service worker, content script के लॉग कहाँ होते हैं, C5 में पूरा नक्शा है।
प्रोजेक्ट संरचना आपकी मर्ज़ी: ऑफिशियल रूप से साफ कहा गया है कि आयोजन का तरीका आज़ाद है, एकमात्र कठोर ज़रूरत यह है कि manifest.json प्लगइन की रूट डायरेक्टरी में हो। TypeScript इस्तेमाल करें तो npm पैकेज chrome-types इंस्टॉल करने से Chrome API का ऑटोकंप्लीट मिलता है—— यह Chromium सोर्स कोड के साथ ऑटोमैटिक अपडेट होता है, ऑफिशियल रूप से बार-बार अपग्रेड करने की सलाह दी गई है।
पाठ का सारांश
✅ Chrome प्लगइन के पहले पाठ में आपने:
- पहला प्लगइन बनाकर सफलतापूर्वक चलाया: फ़ोल्डर +
manifest.json+hello.html, आइकॉन पर क्लिक से Hello Extensions पॉपअप - लोकल लोडिंग के तीन चरण सीखे:
chrome://extensions→ Developer mode → Load unpacked - प्लगइन को टूलबार पर Pin करके कभी भी इस्तेमाल करना
- रीलोड नियम याद रखे: manifest, service worker, content scripts बदलने के बाद refresh करें, popup को नहीं
- लॉग का पहला प्रवेश बिंदु जानते हैं: पॉपअप पर राइट-क्लिक Inspect
मुख्य कॉन्फ़िगरेशन फ़ील्ड की समीक्षा:
| फ़ील्ड | इस पाठ का मान | विवरण |
|---|---|---|
manifest_version | 3 | एकमात्र सपोर्टेड मान, 2 मत लिखें |
name | Hello Extensions | प्लगइन का नाम |
description | Base Level Extension | विवरण |
version | 1.0 | वर्ज़न नंबर, 1-4 खंडों में डॉट से अलग पूर्णांक |
action.default_popup | hello.html | आइकॉन क्लिक पर पॉप होने वाला पेज |
action.default_icon | hello_extensions.png | आइकॉन; न लिखें तो जेनेरिक आइकॉन इस्तेमाल होता है |
अगले पाठ की झलक
अगले पाठ C3 manifest.json विस्तार से: इस सबसे छोटी स्पेसिफ़िकेशन को फ़ील्ड-दर-फ़ील्ड खोलकर देखेंगे। आप सीखेंगे:
- तीन अनिवार्य फ़ील्ड के नियम:
nameअधिकतम 75 अक्षर,versionके फ़ॉर्मेट की बारीकियाँ - स्टोर पर प्रकाशित करने के लिए ज़रूरी फ़ील्ड:
description(अधिकतम 132 अक्षर),icons content_scripts,permissionsजैसे अक्सर इस्तेमाल होने वाले वैकल्पिक फ़ील्ड कैसे लिखें- स्टोर पर अपलोड करने के बाद एक टाइपो ठीक करने के लिए भी वर्ज़न नंबर बढ़ाकर दोबारा पैकेज क्यों करना पड़ता है
तैयार हैं तो C3 पर आगे बढ़ें →