Skip to content

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, versionChrome सीधे लोड से मना कर देता है, एरर डायलॉग बॉक्स दिखाता है
स्टोर अपलोड के लिए अनिवार्य (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 बनाएँ (या खोलें) और लिखें:

json
{
  "manifest_version": 3,
  "name": "My First Extension",
  "version": "1.0.0"
}

तीनों की अपनी-अपनी सीमाएँ:

फ़ील्डसीमाविवरण
manifest_versionकेवल 3 समर्थितMV3 अभी एकमात्र मान्य लेखन शैली है, पुराने ट्यूटोरियल का 2 कॉपी न करें
nameअधिकतम 75 अक्षरस्टोर, इंस्टॉल संवाद और chrome://extensions पेज पर दिखता है
version1-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 की जगह अपने प्लगइन का नाम भी रख सकते हैं):

json
{
  "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 में ये दोनों कीज़ जोड़ें (ध्यान दें: पिछली की के अंत में कॉमा लगाना न भूलें):

json
"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 में यह हिस्सा जोड़ें:

json
"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 में ये दो पंक्तियाँ जोड़ें:

json
"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 और स्टोर ही तय करते हैं। पहले लोकल में एक बार जाँच लें, अपलोड से पहले फिर से मिला लें—सबसे महँगा रीवर्क बच जाएगा।

कदम:

  1. chrome://extensions पर लौटें और प्लगइन कार्ड पर रिफ़्रेश आइकन दबाएँ (तीन-चरण लोडिंग विधि पिछले पाठ में समझाई गई थी)
  2. लोडिंग विफल होने पर एरर संवाद खुलेगा—एरर देखकर manifest ठीक करें, फिर दोबारा रिफ़्रेश करें
  3. अपलोड की तैयारी के समय, आइटम-दर-आइटम जाँचें:
जाँच आइटममानक
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पूर्णांक, एकमात्र समर्थित मान 3manifest प्रारूप का संस्करण
name≤75 अक्षरस्टोर, इंस्टॉलेशन डायलॉग और chrome://extensions में प्रदर्शित नाम
version1-4 खंडों वाले बिंदु-पृथक पूर्णांक, प्रत्येक खंड 0-65536संस्करण संख्या, नया संस्करण अपलोड करते समय पिछले से बड़ा होना अनिवार्य

स्टोर पर प्रकाशन के लिए अनिवार्य (2) ​

फ़ील्डप्रतिबंधउद्देश्य
description≤132 अक्षरस्टोर और एक्सटेंशन प्रबंधन पृष्ठ का विवरण
iconsएक या अधिक आइकनप्लगइन का प्रतिनिधित्व करने वाले आइकन

अधिक उपयोग किए जाने वाले वैकल्पिक (पहले ये 5 जान लें) ​

फ़ील्डलिखने के मुख्य बिंदुउद्देश्य
actiondefault_popup पॉपअप पृष्ठ की ओर इशारा करता है, default_icon आइकन निर्दिष्ट करता हैटूलबार आइकन का स्वरूप और व्यवहार
background{"service_worker": "service-worker.js"}इवेंट हैंडलर के रूप में service worker निर्दिष्ट करता है
content_scriptsmatches अनिवार्य + js / css सरणीमिलान होने वाले वेब पृष्ठ खुलने पर स्वतः इंजेक्ट होने वाली JS/CSS
permissionsAPI नामों की सरणी, जैसे ["storage"]विशिष्ट एक्सटेंशन API सक्षम करता है
host_permissionsmatch pattern सरणीइंटरैक्ट किए जा सकने वाले वेब पृष्ठ घोषित करता है, इंस्टॉल के समय अनुमति माँगता है

अन्य वैकल्पिक फ़ील्ड (उपयोग के अनुसार समूहबद्ध) ​

इंटरफ़ेस और इंटरैक्शन

फ़ील्डउद्देश्य
commandsप्लगइन के भीतर कीबोर्ड शॉर्टकट परिभाषित करता है
options_pageoptions.html को प्लगइन के सेटिंग पृष्ठ के रूप में निर्दिष्ट करता है
options_uiउपयोगकर्ताओं को एक्सटेंशन प्रबंधन पृष्ठ के भीतर प्लगइन विकल्प बदलने देता है
side_panelसाइड पैनल में प्रदर्शित होने वाला HTML पृष्ठ निर्दिष्ट करता है
omniboxChrome एड्रेस बार में कीवर्ड पंजीकृत करता है
chrome_url_overridesChrome के डिफ़ॉल्ट पृष्ठों को बदलता है
devtools_pageDevTools 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डिक्लेरेटिव नेटवर्क रिक्वेस्ट के स्टैटिक नियम, नेटवर्क रिक्वेस्ट को रोक और संशोधित कर सकते हैं
oauth2OAuth कॉन्फ़िगर करता है 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_overridesChrome की कुछ सेटिंग्स को ओवरराइड करता है
cross_origin_embedder_policyCross-Origin-Embedder-Policy अनुरोध हेडर कॉन्फ़िगर करता है
cross_origin_opener_policyCross-Origin-Opener-Policy अनुरोध हेडर कॉन्फ़िगर करता है

ChromeOS के लिए विशेष (4 आइटम)

फ़ील्डउद्देश्य
file_browser_handlersChromeOS फ़ाइल ब्राउज़र से संबंधित API तक पहुँच
file_handlersChromeOS एक्सटेंशन द्वारा संभाली जाने वाली फ़ाइल प्रकार निर्दिष्ट करता है
file_system_provider_capabilitiesएक्सटेंशन को ChromeOS पर उपयोग योग्य फ़ाइल सिस्टम बनाने देता है
input_componentsइनपुट मेथड एडिटर (IME) API का उपयोग करता है

चेकपॉइंट ✅ ​

  • manifest.json एक्सटेंशन की रूट डायरेक्टरी में है, और JSON में कोई टिप्पणी नहीं है
  • manifest_version 3 है; name ≤75 अक्षर; version 1-4 डॉट-सेपरेटेड पूर्णांक है
  • स्टोर पर अपलोड करने के लिए: description ≤132 अक्षर, icons का हर पथ वास्तव में मौजूद है
  • content_scripts का matches लिखा गया है, और वह match pattern सिंटैक्स के अनुरूप है
  • permissions में केवल वही API घोषित हैं जो वास्तव में उपयोग होते हैं, कोई वर्तनी की गलती नहीं

आम गलतियों की चेतावनी ​

❌ manifest.json में टिप्पणी लिखना ​

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 लापरवाही से लिखना, नया संस्करण अपलोड करने पर अस्वीकृत ​

json
"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 की भूमिका: version Chrome के तुलना करने वाला मशीन संस्करण नंबर है; version_name (जैसे "1.0 beta") मनुष्यों के लिए पढ़ने योग्य उपनाम है जो एक्सटेंशन मैनेजमेंट पेज पर दिखता है। "सुंदर संस्करण नाम + सख्ती से बढ़ता संस्करण नंबर" चाहिए तो दोनों लिखें
  • short_name मददगार: नाम बहुत लंबा हो और दिखाने की जगह कम हो तो short_name (≤12 अक्षर) काम आता है; न लिखने पर Chrome name को काटकर दिखाता है

पाठ का सारांश ​

✅ इस पाठ में आपने ये पूरा किए:

  • manifest.json की स्तरित संरचना: प्लेटफ़ॉर्म के लिए अनिवार्य 3 आइटम, स्टोर के लिए अनिवार्य 2 आइटम, वैकल्पिक 41 आइटम (ChromeOS के लिए विशेष 4 आइटम सहित)
  • सबसे छोटे उदाहरण से शुरू करके action, background, content_scripts, permissions की पूरी लेखन शैली तक पहुँचना
  • version के फ़ॉर्मैट नियम और "केवल बढ़ाएँ" अनुशासन, साथ में JSON में टिप्पणी नहीं और रूट डायरेक्टरी — ये दो लौह नियम
  • स्टोर पर अपलोड से पहले की जाँच सूची: मेटाडेटा अपलोड के बाद नहीं बदल सकता, गलती सुधार = नया संस्करण जारी करना

मुख्य कॉन्फ़िगरेशन फ़ील्ड की समीक्षा:

फ़ील्डअनुशंसित मान / सीमाविवरण
manifest_version3एकमात्र समर्थित मान
name≤75 अक्षरतीन जगहों पर दिखाया जाने वाला प्लगइन नाम
version0.0.0.1 से शुरू, केवल बढ़ता है1-4 बिंदु-विभाजित पूर्णांक खंड, प्रत्येक खंड 0-65536
description≤132 अक्षरस्टोर के लिए अनिवार्य
icons48 / 128 दो स्तरों से शुरूस्टोर के लिए अनिवार्य, पथ मौजूद होना चाहिए
action.default_popuphello.htmlआइकन पर क्लिक करने पर खुलने वाला पॉपअप पेज
background.service_workerservice-worker.jsघटना केंद्र स्क्रिप्ट
content_scripts[].matchesmatch pattern, अनिवार्यतय करता है कि कौन से पेज में इंजेक्ट होगा
permissionsकेवल उपयोग की जाने वाली API सूचीबद्ध करेंजैसे ["storage"]
host_permissionsmatch pattern की सरणीइंस्टॉल के समय अनुमति मांगता है

अगले पाठ की झलक ​

फ़ील्ड घोषित कर दिए गए, अगले पाठ C4 Content Script और Service Worker: प्लगइन का दिमाग और हाथ-पैर manifest में इन दो फ़ील्ड के पीछे की प्रणाली को पूरी तरह समझाता है।

आप सीखेंगे:

  • content script और service worker की आधिकारिक परिभाषा, प्रत्येक क्या कर सकता है
  • "आइसोलेटेड वर्ल्ड": क्यों आपकी स्क्रिप्ट और वेबपेज के वेरिएबल एक-दूसरे को नहीं देख सकते
  • स्टैटिक घोषणा, डायनामिक घोषणा, प्रोग्रामेटिक इंजेक्शन — तीन तरीकों में से कौन सा चुनें
  • service worker की आवश्यकता पर शुरू होने और खाली होने पर रुक जाने की आदत, और कब किसका उपयोग करें
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.