Skip to content

Content Script और Service Worker: एक्सटेंशन का दिमाग और हाथ-पैर ​

पिछले पाठ में आपने manifest.json से एक्सटेंशन का ढाँचा तैयार किया। इस पाठ में एक्सटेंशन के दो सबसे अहम रोल्स से परिचय कराते हैं: service worker दिमाग है, जो बैकग्राउंड में रहकर इवेंट का जवाब देता है; content script हाथ-पैर है, जो वेबपेज में घुसकर पेज पढ़ता और बदलता है। इन दोनों रोल्स में फर्क समझ लेंगे तभी आप ज़रूरत साफ़ बता पाएँगे, और AI कोड सही फ़ाइल में रख पाएगा।

सीखने के बाद आप क्या कर सकेंगे ​

  • साफ़ बता पाना कि content script और service worker क्या-क्या कर सकते हैं और क्या नहीं
  • manifest.json में background service worker और content_scripts डिक्लेयर करना, और उन्हें सच में चालू कर पाना
  • खुद वेरिफाई करना कि "isolated world (आइसोलेटेड वर्ल्ड)": वेबपेज और आपकी स्क्रिप्ट एक-दूसरे के JS वेरिएबल नहीं देख सकते, फिर भी एक ही DOM शेयर करते हैं
  • यह जानना कि दोनों के लॉग कहाँ देखने हैं—यही अगले पाठ की डिबगिंग की नींव है

आपकी अभी की दिक्कत ​

  • AI से एक्सटेंशन लिखवाया, तो उसने एक साथ service-worker.js और content-script.js बना दिए, और आपको नहीं पता कि दो क्यों हैं और कौन क्या संभालता है
  • स्क्रिप्ट पेज में इंजेक्ट हुई, फिर भी वेबपेज के अपने वेरिएबल नहीं पढ़ पाई; बैकग्राउंड से पेज बदलना चाहा तो AI ने कहा "नहीं हो सकता"
  • कोड में console.log लगाया, लेकिन आउटपुट नहीं मिला: न एक्सटेंशन पेज पर, न वेबपेज कंसोल में

इस तरकीब को कब इस्तेमाल करें ​

यह पाठ ऐसे आपके लिए है: जो एक्सटेंशन में "वेबपेज बदलने" या "बैकग्राउंड में ब्राउज़र इवेंट का जवाब देने" की क्षमता जोड़ना चाहते हैं, या AI के बनाए एक्सटेंशन की फ़ाइल संरचना समझना चाहते हैं।

और जो नहीं चाहते: कोड गलत फ़ाइल में रखकर बार-बार दोबारा करना, और एरर आने पर भी यह न जानना कि लॉग कहाँ देखने हैं।

🎒 शुरू करने से पहले की तैयारी ​

  • पूर्व-आवश्यक पाठ पढ़ लेना《manifest.json विस्तृत व्याख्या: MV3 फ़ील्ड्स की क्विक रेफ़रेंस》
  • हाथ में एक ऐसा एक्सटेंशन प्रोजेक्ट होना जिसे Load unpacked से लोकली लोड किया जा सके (Hello Extensions जैसा भी चलेगा)
  • chrome://extensions खोलना और एक्सटेंशन रीलोड करना आना (एक्सटेंशन कार्ड पर रिफ़्रेश आइकन पर क्लिक करें)
  • वेबपेज का DevTools खोलना आना (पेज पर राइट-क्लिक → "Inspect") Console देखने के लिए

कोर आइडिया ​

एक्सटेंशन को एक इंसान की तरह सोचें:

  • service worker (दिमाग, यानी एक्सटेंशन बैकग्राउंड स्क्रिप्ट): आधिकारिक तौर पर इसे एक्सटेंशन का "central event handler" (इवेंट हब) कहा जाता है। यह किसी पेज से जुड़ा नहीं होता, ब्राउज़र के बैकग्राउंड में इवेंट का इंतज़ार करता है—टैब बंद करना, नोटिफिकेशन पर क्लिक, नए पेज पर नेविगेट करना सब इसी के अधीन है; "ज़रूरत पर लोड, खाली होने पर अनलोड"। यह DOM तक पहुँच नहीं सकता, पेज बदलना हो तो content script को ही आदेश देना पड़ता है।
  • content script (हाथ-पैर): आधिकारिक परिभाषा है "वेबपेज के एनवायरनमेंट में चलने वाली फ़ाइल", जो स्टैंडर्ड DOM से पेज पढ़ती, बदलती और जानकारी एक्सटेंशन मुख्य भाग को वापस भेजती है।
  • isolated world (आइसोलेटेड वर्ल्ड): content script एक निजी एक्ज़ीक्यूशन एनवायरनमेंट में रहता है, वेबपेज और दूसरे एक्सटेंशन उस तक नहीं पहुँच सकते; वेबपेज के JS वेरिएबल भी यह नहीं देख सकता। लेकिन DOM शेयर होता है—दोनों तरफ एक ही पेज दिखता है।
content script (हाथ-पैर)service worker (दिमाग)
चलने की जगहकिसी खास वेबपेज मेंब्राउज़र बैकग्राउंड, किसी पेज से नहीं जुड़ा
DOM पर काम कर सकता है?✅ पढ़ और बदल सकता है❌ नहीं
लाइफ़साइकिलपेज के साथज़रूरत पर चालू, खाली होने पर बंद
सीधे उपलब्ध एक्सटेंशन APIकुछ ही (dom, i18n, storage, runtime के कुछ मेथड)इवेंट हब की तरह तरह-तरह के एक्सटेंशन इवेंट का जवाब देना
टिपिकल टास्कपेज की स्टाइल बदलना, पेज का कंटेंट पढ़नाटैब/नोटिफिकेशन जैसे इवेंट सुनना, टैब मैनेज करना
लॉग कहाँ देखेंहोस्ट वेबपेज का Consoleएक्सटेंशन पेज के Inspect views

💡 पुराने ट्यूटोरियल से मेल नहीं खा रहा?

MV2 पुराने ट्यूटोरियल का "background script" आज का service worker ही है—नाम बदला, रोल नहीं। अब एक्सटेंशन केवल MV3 में लिखें, पुराना कोड कॉपी न करें।

मेरे साथ करें ​

चरण 1: service worker डिक्लेयर करें (एक्सटेंशन बैकग्राउंड स्क्रिप्ट) ​

क्यों: दिमाग को पहले रजिस्टर करना होगा, तभी Chrome को पता चलेगा कि बैकग्राउंड में किसे चालू करना है।

manifest.json में यह जोड़ें background:

json
"background": {
  "service_worker": "service-worker.js"
}

एक्सटेंशन की रूट डायरेक्टरी में यह नई फ़ाइल बनाएँ service-worker.js:

js
console.log("service worker 已启动");

chrome://extensions पर लौटें और एक्सटेंशन रीलोड करें।

आपको यह दिखना चाहिए: एक्सटेंशन कार्ड पर Inspect views सेक्शन दिखेगा, जिसके पास एक नीला service worker लिंक होगा; उसे खोलें, DevTools के Console में आपका लॉग पड़ा मिलेगा।

💡 लॉग थोड़ी देर में "गायब" हो जाते हैं?

service worker ज़रूरत पर चालू होता है और खाली होने पर बंद। थोड़ी देर में वह सो जाता है, इसका मतलब खराब नहीं—अगली बार इवेंट आने पर वह खुद जाग जाएगा।

  • छोटी जाँच: Inspect views से खुले DevTools में "service worker चालू हो गया" दिखना

चरण 2: पहला content script लिखें (content_scripts स्टैटिक इंजेक्शन) ​

क्यों: हाथ-पैर अपने आप नहीं उग आते—इन्हें manifest में content_scripts के ज़रिए स्थिर रूप से (statically) घोषित करना होगा, तभी ये आपकी निर्दिष्ट वेबसाइटों में अपने आप इंजेक्ट होंगे।

manifest.json में जोड़ें (matches अनिवार्य है, यह तय करता है कि कौन से पेजों में इंजेक्ट होगा; नीचे आधिकारिक दस्तावेज़ का उदाहरण है, डोमेन को उस वेबसाइट से बदलें जिस पर आप वास्तव में असर चाहते हैं):

json
"content_scripts": [
  {
    "matches": ["https://*.nytimes.com/*"],
    "js": ["content-script.js"]
  }
]

आधिकारिक उदाहरण में एक पंक्ति "css": ["my-styles.css"] भी है—content script केवल JS इंजेक्ट कर सकता है, केवल CSS, या दोनों, ज़रूरत के अनुसार चुनें।

एक्सटेंशन की रूट डायरेक्टरी में content-script.js बनाएँ:

js
console.log("[content script] 注入成功,页面标题:", document.title);
document.body.style.border = "5px solid red";

एक्सटेंशन रीलोड करें, फिर लक्ष्य वेबपेज को रिफ्रेश करें—content script बदलने पर "एक्सटेंशन रीलोड + होस्ट पेज रिफ्रेश" दोनों कदम करने होंगे।

आपको यह दिखना चाहिए: लक्ष्य वेबपेज के चारों ओर लाल बॉर्डर दिखे; वेबपेज के DevTools के Console में आपके लिखे लॉग दिखें (ध्यान दें: यह वेबपेज का Console है, एक्सटेंशन पेज का नहीं)।

  • छोटी जाँच: लाल बॉर्डर दिखे, और वेबपेज के Console में content script के लॉग दिखें

चरण 3: अपनी आँखों से आइसोलेटेड वर्ल्ड (isolated world) सत्यापित करें ​

क्यों: यहीं नए लोग सबसे ज़्यादा उलझते हैं—"स्क्रिप्ट स्पष्ट रूप से पेज में चल रही है, फिर वेबपेज के वेरिएबल क्यों नहीं पढ़ पाती?" इसका जवाब है आइसोलेटेड वर्ल्ड, खुद हाथ से एक बार देखना सबसे स्पष्ट है।

content-script.js को इसमें बदलें:

js
var extVar = "我来自插件";
console.log("[content script] 我能读到页面标题:", document.title);
document.body.style.border = "5px solid red";

// 5 秒后再读网页变量,留时间给你在网页控制台定义它
setTimeout(function () {
  console.log("[content script] 读网页变量 pageVar:", window.pageVar);
}, 5000);

एक्सटेंशन रीलोड करें + पेज रिफ्रेश करें, फिर 5 सेकंड के भीतर वेबपेज के Console पर स्विच करें और टाइप करें:

js
var pageVar = "我是网页自己的变量";

5 सेकंड का लॉग आने के बाद, वेबपेज के Console में क्रमशः extVar और document.body.style.border टाइप करें।

आपको यह दिखना चाहिए:

  • content script 读网页变量 pageVar:undefined प्रिंट करता है—यह वेबपेज के वेरिएबल नहीं देख सकता

  • वेबपेज Console में extVar टाइप करने पर ReferenceError मिलता है—वेबपेज भी आपके वेरिएबल नहीं देख सकता

  • document.body.style.border "5px solid red" लौटाता है—DOM दोनों ओर साझा है

  • छोटी जाँच: तीनों घटनाएँ अपनी आँखों से देखी हों, "वेरिएबल आइसोलेटेड, DOM साझा" इस वाक्य से मेल खा जाए

चरण 4: काम को सही भूमिका को सौंपें (कब किसका उपयोग करें) ​

क्यों: दिमाग और हाथ-पैर में अंतर कर पाएंगे, तभी आप अपनी ज़रूरत AI को सही ढंग से बता पाएंगे, और तभी वह कोड गलत फ़ाइल में नहीं लिखेगा।

आपकी ज़रूरतकिसे सौंपें
किसी विशिष्ट वेबपेज पर कोड इंजेक्ट करना, पेज बदलनाcontent script
पेज पर निर्भर न होना, बैकग्राउंड में इवेंट का इंतज़ार, ब्राउज़र व्यवहार पर नज़र, नोटिफिकेशन भेजना/टैब प्रबंधनservice worker
टूलबार आइकन पर क्लिक करके छोटी विंडो (popup) खोलनाaction + popup
नेटवर्क रिक्वेस्ट को रोकना, ब्लॉक करना या बदलनाdeclarativeNetRequest

content script सीधे उपयोग कर सकने वाले एक्सटेंशन API बहुत कम हैं—आधिकारिक रूप से सूचीबद्ध हैं dom, i18n, storage और runtime के कुछ तरीके (जैसे runtime.sendMessage(), runtime.onMessage)। अन्य API का उपयोग करने के लिए, रिक्वेस्ट को संदेश के ज़रिए service worker को भेजना होगा—इसीलिए ये दो फ़ाइलें अक्सर जोड़ी में दिखती हैं, AI ने ज़्यादा नहीं लिखा है।

आपको यह दिखना चाहिए: AI से जनरेट किए कोड को इस तालिका से मिलाएँ—पेज बदलने का लॉजिक content-script.js में, इवेंट लिसनर service-worker.js में—सब अपनी-अपनी जगह पर हों, तो आप एक्सटेंशन की संरचना समझ सकेंगे।

चेकपॉइंट ✅ ​

  • एक्सटेंशन पेज के Inspect views से service worker का DevTools खुल सके, स्टार्टअप लॉग दिखें
  • लक्ष्य वेबपेज पर content script के बदलाव दिखें, लॉग वेबपेज के Console में हों
  • प्रदर्शित कर सकें: वेबपेज के वेरिएबल और content script के वेरिएबल एक-दूसरे को न दिखें, DOM साझा हो
  • बता सकें कि 4 प्रकार की ज़रूरतें किस भूमिका को सौंपी जाती हैं
  • पता हो कि content script बदलने के बाद "एक्सटेंशन रीलोड + पेज रिफ्रेश" दोनों कदम करने होते हैं

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

❌ service worker में document.querySelector(...) लिखना ​

कारण: service worker DOM तक नहीं पहुँच सकता, यह कोड अनिवार्य रूप से विफल होगा।

सही तरीका: पेज बदलने का सारा काम content script को सौंपें; service worker केवल इवेंट संभाले, पेज में बदलाव चाहिए तो संदेश के ज़रिए content script से करवाए।

❌ content script में सीधे अन्य एक्सटेंशन API कॉल करना ​

कारण: आधिकारिक रूप से स्पष्ट कहा गया है कि content script "unable to access other APIs directly"—यह केवल dom, i18n, storage और runtime के कुछ तरीके सीधे उपयोग कर सकता है।

सही तरीका: runtime.sendMessage() से रिक्वेस्ट को service worker को भेजें, वह काम करके परिणाम वापस भेजे।

❌ content script बदला, पेज पर कोई बदलाव नहीं ​

कारण: content script के बदलाव के लिए "एक्सटेंशन रीलोड + होस्ट पेज रिफ्रेश" दोनों कदम चाहिए, एक भी कम हो तो असर नहीं दिखेगा।

सही तरीका: पहले chrome://extensions पर जाकर रीलोड करें, फिर लक्ष्य वेबपेज रिफ्रेश करें।

❌ एक्सटेंशन पेज पर content script का console.log खोजना ​

कारण: एक्सटेंशन पेज का Errors बटन केवल runtime errors, console.warning, console.error रिकॉर्ड करता है, सामान्य console.log नहीं; content script के लॉग होस्ट वेबपेज के Console में होते हैं।

सही तरीका: content script के लॉग वेबपेज पर देखें; service worker के लॉग ही एक्सटेंशन पेज के Inspect views में होते हैं। एरर न मिले तो पहले 《报错循环:把错误信息原样喂回去》 पर लौटें और एरर को AI को वैसा ही दे दें।

उन्नत तकनीकें ​

  • स्थिर घोषणा के अलावा इंजेक्शन के और भी दो तरीके हैं: डायनामिक घोषणा chrome.scripting.registerContentScripts (Chrome 96+), और प्रोग्रामेटिक इंजेक्शन scripting.executeScript (एक्सटेंशन ज़रूरत पड़ने पर इंजेक्ट करता है, जैसे टूलबार आइकन पर क्लिक करने पर; इसके लिए host परमिशन या अस्थायी अनुमति activeTab चाहिए)।
  • आधिकारिक ट्यूटोरियल के अगले कुछ लेख ठीक भूमिका के हिसाब से आगे बढ़ते हैं: Run scripts on every page, Inject scripts into the active tab, Handle events with service workers—यह पाठ पूरा करने के बाद सीधे उनका अनुसरण कर सकते हैं।
  • service worker की नींद-जागना टेस्ट करना चाहें: उसके DevTools में Application → Service Workers पैनल खोलकर मैन्युअली start/stop करें। ध्यान दें: service worker को Inspect (जाँच) करने से वह लगातार सक्रिय रहता है, टेस्ट के बाद DevTools बंद करना न भूलें।

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

✅ दोनों भूमिकाओं को एक वाक्य में याद रखें:

  • service worker = दिमाग: एक्सटेंशन का इवेंट केंद्र, ज़रूरत पर चालू, खाली होते ही बंद, DOM छू नहीं सकता
  • content script = हाथ-पैर: वेबपेज में जीता है, पेज पढ़ और बदल सकता है, आइसोलेटेड वर्ल्ड द्वारा सुरक्षित
  • आइसोलेटेड वर्ल्ड: JS वेरिएबल एक-दूसरे को नहीं दिखते, DOM दोनों ओर साझा
  • लॉग की जगह: content script → होस्ट वेबपेज का Console; service worker → एक्सटेंशन पेज के Inspect views

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

फ़ील्डअनुशंसित मानविवरण
background.service_worker"service-worker.js"MV3 के background script की घोषणा करें (MV2 का background script यही है)
content_scripts[].matchesलक्ष्य वेबसाइट का match patternअनिवार्य, यह तय करता है कि किन पेजों में इंजेक्ट होगा
content_scripts[].js["content-script.js"]इंजेक्ट की जाने वाली JS फ़ाइलों की सूची

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

दोनों रोल्स के लॉग में से एक वेबपेज में और एक एक्सटेंशन पेज में छिपा होता है — अगला पाठ 《प्लगइन कॉल नहीं हो रहा: लॉग कहाँ मिलें, एरर कैसे पढ़ें》 इन जगहों को एक साथ पूरी तरह समझाता है। आप सीखेंगे:

  • manifest गलत लिखे जाने या परमिशन गलत स्पेल होने पर एरर क्रमशः कहाँ दिखेंगे
  • popup, content script और service worker के लॉग क्रमशः कहाँ देखने हैं
  • एक्सटेंशन पेज के Errors बटन से समस्या को जल्दी लोकेट कैसे करें
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.