manifest.json विस्तृत जानकारी: MV3 फ़ील्ड क्विक रेफ़रेंस
💡 एक वाक्य में सारांश: manifest.json एक्सटेंशन की एकमात्र फ़ाइल है जिसके बिना काम नहीं चलेगा—3 प्लेटफ़ॉर्म के अनिवार्य फ़ील्ड नींव बनाते हैं, 2 स्टोर के अनिवार्य फ़ील्ड स्टोर पर अपलोड के लिए चाहिए, बाकी को फ़ंक्शन के अनुसार जोड़ते जाएँ।
पिछले पाठ C2 पहला Chrome एक्सटेंशन में manifest.json को अक्षरशः कॉपी किया था: वह चल गया, लेकिन हर फ़ील्ड ऐसा क्यों लिखा गया है, यह ज़रूरी नहीं कि समझा जा सके। इस पाठ में हम इसे एक-एक करके खोलेंगे—कौन से फ़ील्ड के बिना Chrome सीधे लोड करने से मना कर देता है, कौन से केवल स्टोर अपलोड के समय जाँचे जाते हैं, और अक्सर उपयोग होने वाले वैकल्पिक फ़ील्ड कैसे लिखे जाते हैं। आगे से चाहे खुद लिखें या AI से बनवाएँ, आप समझ सकेंगे, बदल सकेंगे और त्रुटियाँ खोज सकेंगे।
सीखने के बाद आप क्या कर सकेंगे
- manifest.json के 3 प्लेटफ़ॉर्म के अनिवार्य फ़ील्ड और 2 स्टोर के अनिवार्य फ़ील्ड बता सकें, साथ ही उनकी लंबाई और फ़ॉर्मैट की सीमाएँ भी
- न्यूनतम उदाहरण से शुरू करके action, background, content_scripts, permissions को एक-एक करके अपने manifest में जोड़ सकें
- एक MV3 फ़ील्ड क्विक रेफ़रेंस टेबल से सभी 46 फ़ील्ड के कार्य खोज सकें
- नए लोगों की तीन बड़ी गलतियों से बचें: JSON में कमेंट लिखना, MV2 के पुराने ट्यूटोरियल कॉपी करना, और वर्ज़न नंबर नियम के अनुसार न होना
- स्टोर पर अपलोड से पहले सूची के अनुसार जाँच कर सकें, और जान सकें कि कौन सी जानकारी अपलोड के बाद नहीं बदल सकती
आपकी अभी की दिक्कत
- "AI ने मेरे लिए manifest.json बना दिया, लेकिन कौन सा फ़ील्ड अनिवार्य है, कौन सा फ़ील्ड किस काम का है, मुझे बिल्कुल समझ नहीं आता"
- "इंटरनेट के पुराने ट्यूटोरियल से कॉपी करता हूँ, फ़ील्ड कभी मेल नहीं खाते—बाद में पता चला कि वह MV2 की लिखावट थी, मेहनत बेकार गई"
- "लोकल लोड पर सब ठीक चलता है, लेकिन स्टोर पर अपलोड करते ही Cannot parse the manifest एरर आता है, आधे दिन खोजने पर भी नहीं पता चलता कि गलती कहाँ है"
यह तरीक़ा कब उपयोग करें
जब आपको चाहिए:
- किसी manifest फ़ील्ड की लिखावट और सीमाएँ खोजना (name अधिकतम कितना लंबा, version में कितने हिस्से लिख सकते हैं)
- शून्य से एक लोड होने योग्य manifest.json बनाना, या मौजूदा एक्सटेंशन में नए फ़ंक्शन के फ़ील्ड जोड़ना
- स्टोर पर अपलोड से पहले अनिवार्य आइटम जाँचना, ताकि "अपलोड के बाद गलती पता चलने" वाली स्थिति अपलोड से पहले ही खत्म हो जाए
और आप नहीं चाहते:
- आधिकारिक दस्तावेज़ में 46 फ़ील्ड की पूरी जानकारी पढ़ना—क्विक रेफ़रेंस टेबल नीचे एक ही स्क्रीन पर है
- फ़ील्ड गलत लिखने की वजह से Chrome द्वारा लोड से मना किया जाना, या स्टोर द्वारा अस्वीकार किया जाना
- MV2 और MV3 की लिखावट में फ़र्क़ न कर पाना, गलत ट्यूटोरियल कॉपी करके सोचना कि Chrome खराब हो गया है
🎒 शुरू करने से पहले की तैयारी
- C2 पहला Chrome एक्सटेंशन पूरा करना, जिससे आपके पास वह चलने योग्य Hello World manifest.json हाथ में हो
- JSON फ़ाइलें संपादित करने का कोई टूल (नोटपैड भी चलेगा, VS Code जैसे एडिटर ज़्यादा आरामदेह हैं)
chrome://extensionsएक्सटेंशन मैनेजमेंट पेज खुला रखना, ताकि कभी भी रिफ़्रेश करके सत्यापित किया जा सके- 10 मिनट
मुख्य विचार
Chrome की हर एक्सटेंशन के लिए केवल एक कड़ी आवश्यकता है: रूट डायरेक्टरी में एक manifest.json होना अनिवार्य है, यह एक्सटेंशन की संरचना और व्यवहार की जानकारी सूचीबद्ध करता है—Chrome इसी से एक्सटेंशन को पहचानता है, स्टोर इसी से एक्सटेंशन की समीक्षा करता है।
आधिकारिक रूप से सभी 46 फ़ील्ड को चार समूहों में बाँटा गया है, नए लोग पहले दो समूह याद रखें:
| समूह | फ़ील्ड | गायब होने पर क्या होगा |
|---|---|---|
| प्लेटफ़ॉर्म अनिवार्य (3) | manifest_version, name, version | Chrome सीधे लोड से मना कर देता है, एरर डायलॉग बॉक्स दिखाता है |
| स्टोर अपलोड के लिए अनिवार्य (2) | description, icons | लोकल पर चलता है, स्टोर पर अपलोड नहीं होता |
| वैकल्पिक (37) | action, background, content_scripts, permissions आदि | गायब नहीं है, फ़ंक्शन के अनुसार जोड़ें |
| वैकल्पिक·ChromeOS विशेष (4) | file_handlers आदि | डेस्कटॉप Chrome एक्सटेंशन में लगभग उपयोग नहीं होता |
दो नियम जो पूरे पेज पर लागू होते हैं, पहले याद रख लें:
- JSON में कमेंट नहीं लिख सकते—स्टोर पर अपलोड करने पर
Cannot parse the manifestएरर आएगा - manifest.json रूट डायरेक्टरी में होना चाहिए—लोकल लोड करते समय एक्सटेंशन फ़ोल्डर चुना जाता है, और स्टोर के लिए zip पैकेज करते समय भी manifest संपीड़ित पैकेज की रूट डायरेक्टरी में होना चाहिए, एक फ़ोल्डर के अंदर नहीं रखना चाहिए
मेरे साथ करें
आगे हम एक manifest.json को 3 फ़ील्ड से लेकर धीरे-धीरे 10 फ़ील्ड तक बढ़ाएँगे। पिछले पाठ वाले Hello World फ़ोल्डर में ही बदलाव करें, और हर बदलाव के बाद chrome://extensions पर जाकर प्लगइन कार्ड पर रिफ़्रेश आइकन दबाएँ—manifest बदलने के बाद प्लगइन रिफ़्रेश करना ज़रूरी है, तभी बदलाव लागू होते हैं।
चरण 1: प्लेटफ़ॉर्म के अनिवार्य तीन फ़ील्ड लिखें—manifest.json की नींव
क्यों: Chrome प्लगइन लोड करते समय सबसे पहली चीज़ manifest.json पढ़ना है; इन तीनों फ़ील्ड में से कोई एक भी गायब हो तो लोडिंग सीधे विफल हो जाती है।
प्लगइन की रूट डायरेक्टरी में manifest.json बनाएँ (या खोलें) और लिखें:
{
"manifest_version": 3,
"name": "My First Extension",
"version": "1.0.0"
}तीनों की अपनी-अपनी सीमाएँ:
| फ़ील्ड | सीमा | विवरण |
|---|---|---|
manifest_version | केवल 3 समर्थित | MV3 अभी एकमात्र मान्य लेखन शैली है, पुराने ट्यूटोरियल का 2 कॉपी न करें |
name | अधिकतम 75 अक्षर | स्टोर, इंस्टॉल संवाद और chrome://extensions पेज पर दिखता है |
version | 1-4 डॉट-सेपरेटेड पूर्णांक, प्रत्येक खंड 0-65536 | जैसे 1.0.0, फ़ॉर्मैट गलत होने पर Chrome स्पष्ट एरर देता है |
आपको यह दिखना चाहिए: केवल तीन कीज़ वाला एक JSON—प्लेटफ़ॉर्म की सारी ज़रूरत बस इतनी ही है।
फ़ॉर्मैट नियमों की जाँच अपनी आँखों से देखने के लिए version को जानबूझकर "1.0.0.0.0" (पाँच खंड) कर दें और प्लगइन रिफ़्रेश करें, Chrome एरर संवाद दिखाएगा: Required value version is missing or invalid. It must be between 1-4 dot-separated integers each between 0 and 65536.—इसे 1.0.0 पर वापस करते ही सब ठीक हो जाता है।
- छोटी जाँच: manifest.json रूट डायरेक्टरी में है, तीनों फ़ील्ड मौजूद हैं, JSON में कोई कमेंट नहीं है
चरण 2: description और icons जोड़ें—आधिकारिक न्यूनतम उदाहरण पूरा करें
क्यों: ये दोनों आइटम लोकल चलने पर असर नहीं डालते, लेकिन Chrome वेब स्टोर पर अपलोड के समय अनिवार्य जाँच हैं; आधिकारिक दस्तावेज़ का «न्यूनतम manifest उदाहरण» भी इन्हें शामिल करता है।
अभी बनाए JSON में ये दोनों आइटम जोड़ दें—यही आधिकारिक दस्तावेज़ का Minimal Manifest मूल रूप है (name की जगह अपने प्लगइन का नाम भी रख सकते हैं):
{
"manifest_version": 3,
"name": "Minimal Manifest",
"version": "1.0.0",
"description": "A basic example extension with only required keys",
"icons": {
"48": "images/icon-48.png",
"128": "images/icon-128.png"
}
}description: अधिकतम 132 अक्षर, स्टोर और एक्सटेंशन प्रबंधन पेज पर दिखता हैicons: एक या अधिक आइकन; कीज़ आकार हैं, वैल्यू इमेज पाथ हैं
आपको यह दिखना चाहिए: यहीं तक आधिकारिक Minimal Manifest का मूल रूप है। icons जिस इमेज की ओर इशारा करता है वह वास्तव में मौजूद होनी चाहिए—पिछले पाठ के Hello World में इस्तेमाल की गई आइकन फ़ाइल यहीं काम आएगी, बस icons के अंदर का पाथ उसकी वास्तविक जगह के अनुसार बदल दें।
- छोटी जाँच: description 132 अक्षरों से अधिक नहीं है; icons के हर पाथ के लिए फ़ोल्डर में संगत फ़ाइल मिलती है
चरण 3: action और background जोड़ें—पॉपअप और इवेंट हब
क्यों: action तय करता है कि टूलबार आइकन पर क्लिक करने से क्या होता है; background प्लगइन का service worker (इवेंट हैंडलर) निर्दिष्ट करता है। पिछले पाठ का पॉपअप भी action का ही काम था।
manifest में ये दोनों कीज़ जोड़ें (ध्यान दें: पिछली की के अंत में कॉमा लगाना न भूलें):
"action": {
"default_popup": "hello.html",
"default_icon": "hello_extensions.png"
},
"background": {
"service_worker": "service-worker.js"
}action: टूलबार आइकन का रूप और व्यवहार परिभाषित करता है;default_popupआइकन क्लिक करने पर खुलने वाला पेज निर्दिष्ट करता है,default_iconआइकन इमेज निर्दिष्ट करता हैbackground:service_workerजिस JS फ़ाइल की ओर इशारा करता है वह प्लगइन का «दिमाग़» है—ज़रूरत पर चालू, खाली समय पर बंद—इसकी गहराई में अगले पाठ में जाएँगे
आपको यह दिखना चाहिए: प्लगइन रिफ़्रेश करने के बाद टूलबार आइकन पर क्लिक करें, पॉपअप हमेशा की तरह खुलेगा। पहले service-worker.js फ़ाइल बना लेना न भूलें (सामग्री फ़िलहाल एक पंक्ति console.log("background ready") ही ठीक है)—manifest में घोषित हर फ़ाइल पाथ वास्तव में मौजूद होना चाहिए।
चरण 4: content_scripts कॉन्फ़िगरेशन जोड़ें—स्क्रिप्ट निर्दिष्ट वेबपेजों पर अपने आप चलती है
क्यों: अगर आप चाहते हैं कि प्लगइन «किसी श्रेणी का वेबपेज खुलते ही अपने आप पेज बदल दे», तो इसका सहारा content_scripts की स्टैटिक घोषणा ही है—कोई बटन दबाने की ज़रूरत नहीं, स्क्रिप्ट खुद इंजेक्ट हो जाती है।
manifest में यह हिस्सा जोड़ें:
"content_scripts": [
{
"matches": ["https://*.nytimes.com/*"],
"css": ["my-styles.css"],
"js": ["content-script.js"]
}
]matches: अनिवार्य। तय करता है कि स्क्रिप्ट किन पेजों पर इंजेक्ट होगी, match pattern सिंटैक्स में लिखी जाती है (जैसेhttps://*.nytimes.com/*); स्वतः चलने वाले हर content script के लिए match pattern देना अनिवार्य हैjs/css: वैकल्पिक। ऐरे क्रम में इंजेक्ट होने वाली JS / CSS फ़ाइलें, पाथ प्लगइन की रूट डायरेक्टरी से सापेक्ष होते हैं
आपको यह दिखना चाहिए: प्लगइन रिफ़्रेश करने के बाद matches से मैच होने वाला पेज खोलें, स्क्रिप्ट अपने आप लागू हो जाएगी। Content script फ़ाइल बदलने के बाद प्लगइन रिफ़्रेश करने के साथ-साथ होस्ट पेज भी रिफ़्रेश करें। और «मेरी स्क्रिप्ट और वेबपेज के वेरिएबल एक-दूसरे को क्यों नहीं देख पाते»—अगले पाठ C4 में आइसोलेटेड दुनिया समझाई जाएगी।
चरण 5: permissions और host_permissions घोषणाएँ जोड़ें
क्यों: permissions विशिष्ट एक्सटेंशन API सक्रिय करता है, घोषित न करें तो कॉल नहीं हो सकते; host_permissions घोषित करता है कि प्लगइन किन वेबसाइटों से इंटरैक्ट कर सकता है—इन वेबसाइटों की अनुमति इंस्टॉल के समय ही उपयोगकर्ता से माँगी जाती है।
manifest में ये दो पंक्तियाँ जोड़ें:
"permissions": ["storage"],
"host_permissions": ["https://*.example.com/"]permissions: ऐरे में सक्रिय किए जाने वाले API के नाम रखें, जैसेstorage,scripting,activeTab; केवल वही घोषित करें जो वास्तव में उपयोग होता हैhost_permissions: match pattern से उन वेबपेजों की सूची दें जिनसे इंटरैक्ट किया जा सकता है
आपको यह दिखना चाहिए: प्लगइन रिफ़्रेश करें, लोडिंग सामान्य होगी। परमिशन का नाम गलत स्पेल होने पर लोडिंग रद्द नहीं होती, लेकिन एक्सटेंशन पेज पर लाल Errors बटन दिखेगा—जैसे activeTab को activetab लिखने पर Permission 'activetab' is unknown or URL pattern is malformed. संदेश आएगा। डिबगिंग का पूरा तरीका C5 में है।
चरण 6: लोकल लोड से जाँचें, अपलोड से पहले आइटम-दर-आइटम मिलाएँ
क्यों: फ़ील्ड सही लिखे गए या नहीं, यह केवल Chrome और स्टोर ही तय करते हैं। पहले लोकल में एक बार जाँच लें, अपलोड से पहले फिर से मिला लें—सबसे महँगा रीवर्क बच जाएगा।
कदम:
chrome://extensionsपर लौटें और प्लगइन कार्ड पर रिफ़्रेश आइकन दबाएँ (तीन-चरण लोडिंग विधि पिछले पाठ में समझाई गई थी)- लोडिंग विफल होने पर एरर संवाद खुलेगा—एरर देखकर manifest ठीक करें, फिर दोबारा रिफ़्रेश करें
- अपलोड की तैयारी के समय, आइटम-दर-आइटम जाँचें:
| जाँच आइटम | मानक |
|---|---|
name / description | ≤75 / ≤132 अक्षर, कोई वर्तनी त्रुटि नहीं—अपलोड के बाद manifest मेटाडेटा बदला नहीं जा सकता, वर्तनी त्रुटि मिलने पर केवल फ़ाइल ठीक करके, वर्ज़न नंबर बढ़ाकर, दोबारा पैकेज बनाना पड़ता है |
version | पहले अपलोड किए वर्ज़न से बड़ा; पहले वर्ज़न के लिए कम वैल्यू जैसे 0.0.0.1 रखने की सलाह है, ताकि आगे बढ़ाने की जगह बनी रहे |
| टिप्पणियाँ | JSON में कोई भी टिप्पणी न हो, वरना अपलोड करते समय Cannot parse the manifest एरर आएगा |
| पैकेजिंग | zip संपीड़ित पैकेज के रूट डायरेक्टरी में सीधे manifest.json होना चाहिए, कोई फ़ोल्डर की अतिरिक्त परत नहीं |
आपको यह दिखना चाहिए: लोकल लोडिंग पर कोई एरर डायलॉग बॉक्स नहीं, कोई लाल Errors नहीं; स्टोर पर अपलोड किए गए zip को खोलने पर पहली ही परत में manifest.json दिखे। पंजीकरण, समीक्षा के लिए जमा करने और समीक्षा की पूरी प्रक्रिया C6 में है।
📋 MV3 फ़ील्ड क्विक रेफ़रेंस तालिका
::: टिप 💡 इस तालिका का उपयोग कैसे करें पहले दो सवाल पूछें: यह फ़ील्ड किस परत से संबंधित है (प्लेटफ़ॉर्म अनिवार्य / स्टोर अनिवार्य / वैकल्पिक)? मेरी ज़रूरत की सुविधा किस समूह में आती है (इंटरफ़ेस / अनुमतियाँ / नेटवर्क / वितरण)? पंक्ति का पता लगाएँ, उसी अनुसार लिखें, प्रतिबंधों की जाँच करें, फिर पृष्ठ पर संबंधित चरण पर जाकर विस्तृत विवरण देखें। इस तालिका के फ़ील्ड और प्रतिबंध Chrome के आधिकारिक Manifest reference दस्तावेज़ से संकलित किए गए हैं। :::
प्लेटफ़ॉर्म अनिवार्य (3)
| फ़ील्ड | प्रतिबंध | उद्देश्य |
|---|---|---|
manifest_version | पूर्णांक, एकमात्र समर्थित मान 3 | manifest प्रारूप का संस्करण |
name | ≤75 अक्षर | स्टोर, इंस्टॉलेशन डायलॉग और chrome://extensions में प्रदर्शित नाम |
version | 1-4 खंडों वाले बिंदु-पृथक पूर्णांक, प्रत्येक खंड 0-65536 | संस्करण संख्या, नया संस्करण अपलोड करते समय पिछले से बड़ा होना अनिवार्य |
स्टोर पर प्रकाशन के लिए अनिवार्य (2)
| फ़ील्ड | प्रतिबंध | उद्देश्य |
|---|---|---|
description | ≤132 अक्षर | स्टोर और एक्सटेंशन प्रबंधन पृष्ठ का विवरण |
icons | एक या अधिक आइकन | प्लगइन का प्रतिनिधित्व करने वाले आइकन |
अधिक उपयोग किए जाने वाले वैकल्पिक (पहले ये 5 जान लें)
| फ़ील्ड | लिखने के मुख्य बिंदु | उद्देश्य |
|---|---|---|
action | default_popup पॉपअप पृष्ठ की ओर इशारा करता है, default_icon आइकन निर्दिष्ट करता है | टूलबार आइकन का स्वरूप और व्यवहार |
background | {"service_worker": "service-worker.js"} | इवेंट हैंडलर के रूप में service worker निर्दिष्ट करता है |
content_scripts | matches अनिवार्य + js / css सरणी | मिलान होने वाले वेब पृष्ठ खुलने पर स्वतः इंजेक्ट होने वाली JS/CSS |
permissions | API नामों की सरणी, जैसे ["storage"] | विशिष्ट एक्सटेंशन API सक्षम करता है |
host_permissions | match pattern सरणी | इंटरैक्ट किए जा सकने वाले वेब पृष्ठ घोषित करता है, इंस्टॉल के समय अनुमति माँगता है |
अन्य वैकल्पिक फ़ील्ड (उपयोग के अनुसार समूहबद्ध)
इंटरफ़ेस और इंटरैक्शन
| फ़ील्ड | उद्देश्य |
|---|---|
commands | प्लगइन के भीतर कीबोर्ड शॉर्टकट परिभाषित करता है |
options_page | options.html को प्लगइन के सेटिंग पृष्ठ के रूप में निर्दिष्ट करता है |
options_ui | उपयोगकर्ताओं को एक्सटेंशन प्रबंधन पृष्ठ के भीतर प्लगइन विकल्प बदलने देता है |
side_panel | साइड पैनल में प्रदर्शित होने वाला HTML पृष्ठ निर्दिष्ट करता है |
omnibox | Chrome एड्रेस बार में कीवर्ड पंजीकृत करता है |
chrome_url_overrides | Chrome के डिफ़ॉल्ट पृष्ठों को बदलता है |
devtools_page | DevTools API का उपयोग करने वाले पृष्ठ परिभाषित करता है |
अनुमतियाँ और सुरक्षा
| फ़ील्ड | उद्देश्य |
|---|---|
optional_permissions | वैकल्पिक API अनुमतियाँ घोषित करता है |
optional_host_permissions | वैकल्पिक host अनुमतियाँ घोषित करता है |
content_security_policy | प्लगइन द्वारा लोड किए जा सकने वाले स्क्रिप्ट, स्टाइल आदि संसाधनों को सीमित करता है |
externally_connectable | निर्दिष्ट करता है कि कौन से वेब पृष्ठ और प्लगइन आपके प्लगइन से कनेक्ट हो सकते हैं |
web_accessible_resources | वेब पृष्ठों या अन्य प्लगइन्स द्वारा एक्सेस किए जा सकने वाली प्लगइन की फ़ाइलें परिभाषित करता है |
sandbox | ऐसे सैंडबॉक्स पृष्ठ परिभाषित करता है जो सीधे एक्सटेंशन API का उपयोग नहीं कर सकते |
incognito | इनकॉग्निटो मोड में व्यवहार, संभावित मान spanning / split / not_allowed |
key | विकास उद्देश्यों के लिए प्लगइन ID निर्दिष्ट करता है |
नेटवर्क और डेटा
| फ़ील्ड | उद्देश्य |
|---|---|
declarative_net_request | डिक्लेरेटिव नेटवर्क रिक्वेस्ट के स्टैटिक नियम, नेटवर्क रिक्वेस्ट को रोक और संशोधित कर सकते हैं |
oauth2 | OAuth कॉन्फ़िगर करता है 2.0(client_id और scopes) |
storage | मैनेज्ड स्टोरेज क्षेत्र के लिए JSON schema घोषित करता है |
tts_engine | प्लगइन को टेक्स्ट-टू-स्पीच इंजन के रूप में पंजीकृत करता है |
mime_types_handler | एक्सटेंशन को किसी MIME प्रकार (जैसे application/pdf) का हैंडलर के रूप में रजिस्टर करता है |
requirements | एक्सटेंशन के उपयोग के लिए आवश्यक तकनीकों की सूची देता है |
संस्करण और वितरण
| फ़ील्ड | उद्देश्य |
|---|---|
version_name | मनुष्यों के लिए पढ़ने योग्य संस्करण उपनाम (जैसे "1.0 beta"); न लिखने पर version दिखाया जाता है |
minimum_chrome_version | एक्सटेंशन इंस्टॉल करने योग्य न्यूनतम Chrome संस्करण; इससे कम संस्करण पर असंगत दिखता है, इंस्टॉल नहीं होता और ऑटो-अपडेट भी नहीं होता |
homepage_url | एक्सटेंशन के होमपेज का URL; न लिखने पर डिफ़ॉल्ट रूप से स्टोर पेज होता है |
update_url | स्व-होस्टेड वितरण (स्टोर पर अपलोड न करना) के समय अपडेट पेज का पता |
import | एक्सटेंशन में संसाधन आयात करने की अनुमति देता है |
export | एक्सटेंशन से संसाधन निर्यात करने की अनुमति देता है |
अंतर्राष्ट्रीयकरण और प्रदर्शन
| फ़ील्ड | उद्देश्य |
|---|---|
default_locale | बहुभाषी एक्सटेंशन की डिफ़ॉल्ट भाषा (जैसे en); स्थानीयकृत एक्सटेंशन के लिए अनिवार्य है, गैर-स्थानीयकृत एक्सटेंशन में उपयोग नहीं किया जा सकता |
short_name | छोटा नाम, ≤12 अक्षर; न लिखने पर name को काटकर दिखाया जाता है |
Chrome सेटिंग
| फ़ील्ड | उद्देश्य |
|---|---|
chrome_settings_overrides | Chrome की कुछ सेटिंग्स को ओवरराइड करता है |
cross_origin_embedder_policy | Cross-Origin-Embedder-Policy अनुरोध हेडर कॉन्फ़िगर करता है |
cross_origin_opener_policy | Cross-Origin-Opener-Policy अनुरोध हेडर कॉन्फ़िगर करता है |
ChromeOS के लिए विशेष (4 आइटम)
| फ़ील्ड | उद्देश्य |
|---|---|
file_browser_handlers | ChromeOS फ़ाइल ब्राउज़र से संबंधित API तक पहुँच |
file_handlers | ChromeOS एक्सटेंशन द्वारा संभाली जाने वाली फ़ाइल प्रकार निर्दिष्ट करता है |
file_system_provider_capabilities | एक्सटेंशन को ChromeOS पर उपयोग योग्य फ़ाइल सिस्टम बनाने देता है |
input_components | इनपुट मेथड एडिटर (IME) API का उपयोग करता है |
चेकपॉइंट ✅
- manifest.json एक्सटेंशन की रूट डायरेक्टरी में है, और JSON में कोई टिप्पणी नहीं है
manifest_version3 है;name≤75 अक्षर;version1-4 डॉट-सेपरेटेड पूर्णांक है- स्टोर पर अपलोड करने के लिए:
description≤132 अक्षर,iconsका हर पथ वास्तव में मौजूद है content_scriptsकाmatchesलिखा गया है, और वह match pattern सिंटैक्स के अनुरूप हैpermissionsमें केवल वही API घोषित हैं जो वास्तव में उपयोग होते हैं, कोई वर्तनी की गलती नहीं
आम गलतियों की चेतावनी
❌ manifest.json में टिप्पणी लिखना
{
"manifest_version": 3, // MV3 写死
"name": "My Extension"
}कारण: JSON टिप्पणियों का समर्थन नहीं करता, स्टोर अपलोड के समय सीधे Cannot parse the manifest त्रुटि देता है। सही तरीका: अपलोड से पहले सभी टिप्पणियाँ हटा दें; व्याख्या रखनी हो तो README या बगल के दस्तावेज़ में लिखें।
❌ पुराने ट्यूटोरियल की नकल करके manifest_version को 2 लिखना
कारण: इंटरनेट पर बड़ी संख्या में ट्यूटोरियल अब भी MV2 युग की शैली में हैं, जबकि MV3 में manifest_version का एकमात्र समर्थित मान 3 है, पुरानी शैली की नकल करने से मेहनत बेकार जाएगी। सही तरीका: नए एक्सटेंशन में हमेशा "manifest_version": 3; संदेह हो तो फ़ील्ड को इस पेज के क्विक-रेफ़रेंस टेबल से मिलाकर जाँचें।
❌ version लापरवाही से लिखना, नया संस्करण अपलोड करने पर अस्वीकृत
"version": "1.0.0.0.0" // ❌ 五段,超了
"version": "0.0.0.1" // ✅ 初版设低值,以后只往上加कारण: version 1-4 डॉट-सेपरेटेड पूर्णांक होना चाहिए, प्रत्येक खंड 0-65536; और स्टोर यह माँगता है कि हर नए अपलोड का संस्करण नंबर पिछले से बड़ा हो। सही तरीका: पहले संस्करण में 0.0.0.1 जैसा कम मान रखें, हर रिलीज़ में केवल बढ़ाएँ, हमेशा जगह बची रहेगी।
❌ अपलोड के बाद पता चलना कि name में एक वर्तनी की गलती है
कारण: स्टोर पर अपलोड के बाद, manifest मेटाडेटा डेवलपर डैशबोर्ड से बदला नहीं जा सकता — यह अनुमति का मुद्दा नहीं है, नियम ऐसा ही है। सही तरीका: अपलोड से पहले name और description को अक्षर-दर-अक्षर जाँचें; वास्तव में गलती हो तो manifest बदलना, version बढ़ाना और दोबारा पैक करके अपलोड करना ही एक रास्ता है।
🔧 उन्नत टिप्स (वैकल्पिक)
- एडिटर में आधिकारिक manifest schema जोड़ें: कोड एडिटर में manifest schema (json.schemastore.org/chrome-manifest) जोड़ने पर गलत फ़ील्ड या अनिवार्य फ़ील्ड की कमी तुरंत लाल दिखती है, Chrome द्वारा लोड अस्वीकृत होने का इंतज़ार नहीं करना पड़ता
version_nameऔरversionकी भूमिका:versionChrome के तुलना करने वाला मशीन संस्करण नंबर है;version_name(जैसे"1.0 beta") मनुष्यों के लिए पढ़ने योग्य उपनाम है जो एक्सटेंशन मैनेजमेंट पेज पर दिखता है। "सुंदर संस्करण नाम + सख्ती से बढ़ता संस्करण नंबर" चाहिए तो दोनों लिखेंshort_nameमददगार: नाम बहुत लंबा हो और दिखाने की जगह कम हो तोshort_name(≤12 अक्षर) काम आता है; न लिखने पर Chromenameको काटकर दिखाता है
पाठ का सारांश
✅ इस पाठ में आपने ये पूरा किए:
- manifest.json की स्तरित संरचना: प्लेटफ़ॉर्म के लिए अनिवार्य 3 आइटम, स्टोर के लिए अनिवार्य 2 आइटम, वैकल्पिक 41 आइटम (ChromeOS के लिए विशेष 4 आइटम सहित)
- सबसे छोटे उदाहरण से शुरू करके action, background, content_scripts, permissions की पूरी लेखन शैली तक पहुँचना
- version के फ़ॉर्मैट नियम और "केवल बढ़ाएँ" अनुशासन, साथ में JSON में टिप्पणी नहीं और रूट डायरेक्टरी — ये दो लौह नियम
- स्टोर पर अपलोड से पहले की जाँच सूची: मेटाडेटा अपलोड के बाद नहीं बदल सकता, गलती सुधार = नया संस्करण जारी करना
मुख्य कॉन्फ़िगरेशन फ़ील्ड की समीक्षा:
| फ़ील्ड | अनुशंसित मान / सीमा | विवरण |
|---|---|---|
manifest_version | 3 | एकमात्र समर्थित मान |
name | ≤75 अक्षर | तीन जगहों पर दिखाया जाने वाला प्लगइन नाम |
version | 0.0.0.1 से शुरू, केवल बढ़ता है | 1-4 बिंदु-विभाजित पूर्णांक खंड, प्रत्येक खंड 0-65536 |
description | ≤132 अक्षर | स्टोर के लिए अनिवार्य |
icons | 48 / 128 दो स्तरों से शुरू | स्टोर के लिए अनिवार्य, पथ मौजूद होना चाहिए |
action.default_popup | hello.html | आइकन पर क्लिक करने पर खुलने वाला पॉपअप पेज |
background.service_worker | service-worker.js | घटना केंद्र स्क्रिप्ट |
content_scripts[].matches | match pattern, अनिवार्य | तय करता है कि कौन से पेज में इंजेक्ट होगा |
permissions | केवल उपयोग की जाने वाली API सूचीबद्ध करें | जैसे ["storage"] |
host_permissions | match pattern की सरणी | इंस्टॉल के समय अनुमति मांगता है |
अगले पाठ की झलक
फ़ील्ड घोषित कर दिए गए, अगले पाठ C4 Content Script और Service Worker: प्लगइन का दिमाग और हाथ-पैर manifest में इन दो फ़ील्ड के पीछे की प्रणाली को पूरी तरह समझाता है।
आप सीखेंगे:
- content script और service worker की आधिकारिक परिभाषा, प्रत्येक क्या कर सकता है
- "आइसोलेटेड वर्ल्ड": क्यों आपकी स्क्रिप्ट और वेबपेज के वेरिएबल एक-दूसरे को नहीं देख सकते
- स्टैटिक घोषणा, डायनामिक घोषणा, प्रोग्रामेटिक इंजेक्शन — तीन तरीकों में से कौन सा चुनें
- service worker की आवश्यकता पर शुरू होने और खाली होने पर रुक जाने की आदत, और कब किसका उपयोग करें