chrome.tabs

ध्यान दें: Tabs API का इस्तेमाल सर्विस वर्कर और एक्सटेंशन पेजों के लिए किया जा सकता है, लेकिन कॉन्टेंट स्क्रिप्ट का इस्तेमाल नहीं किया जा सकता.

ब्यौरा

ब्राउज़र के टैब सिस्टम से इंटरैक्ट करने के लिए, chrome.tabs एपीआई का इस्तेमाल करें. इस एपीआई का इस्तेमाल ब्राउज़र में टैब बनाने, उनमें बदलाव करने, और उन्हें फिर से व्यवस्थित करने के लिए किया जा सकता है.

Tabs एपीआई, न सिर्फ़ टैब में हेर-फेर और मैनेज करने की सुविधाएं देता है, बल्कि भाषा के बारे में जानने के लिए, स्क्रीनशॉट लें और टैब की कॉन्टेंट स्क्रिप्ट का बातचीत करें.

अनुमतियां

ज़्यादातर सुविधाओं का इस्तेमाल करने के लिए, किसी अनुमति की ज़रूरत नहीं होती. उदाहरण के लिए: नया टैब बनाना, किसी टैब को फिर से लोड करना, किसी दूसरे यूआरएल पर नेविगेशन करना वगैरह.

Tabs एपीआई का इस्तेमाल करते समय, डेवलपर को तीन अनुमतियों के बारे में पता होना चाहिए.

"टैब" अनुमति

यह अनुमति chrome.tabs नेमस्पेस को ऐक्सेस नहीं देती. इसके बजाय, चार के मुकाबले tabs.query() को कॉल करने की एक्सटेंशन देता है tabs.Tab इंस्टेंस पर संवेदनशील प्रॉपर्टी: url, pendingUrl, title, और favIconUrl.

{
  "name": "My extension",
  ...
  "permissions": [
    "tabs"
  ],
  ...
}

होस्ट की अनुमतियां

होस्ट की अनुमतियां, किसी एक्सटेंशन को मेल खाने वाले टैब की चार संवेदनशील जानकारी को पढ़ने और उसके बारे में क्वेरी करने की अनुमति देती हैं tabs.Tab प्रॉपर्टी. वे इन तरीकों का इस्तेमाल करके, मिलते-जुलते टैब से सीधे इंटरैक्ट भी कर सकते हैं tabs.captureVisibleTab() के तौर पर, tabs.executeScript(), tabs.insertCSS(), और tabs.removeCSS().

{
  "name": "My extension",
  ...
  "host_permissions": [
    "http://*/*",
    "https://*/*"
  ],
  ...
}

"activeTab" अनुमति

activeTab, मौजूदा टैब को कुछ समय के लिए होस्ट करने की अनुमति देता है उपयोगकर्ता के बोले जाने का जवाब. activeTab, होस्ट की अनुमतियों के उलट कोई चेतावनी ट्रिगर नहीं करता.

{
  "name": "My extension",
  ...
  "permissions": [
    "activeTab"
  ],
  ...
}

उपयोग के उदाहरण

यहां दिए गए सेक्शन में, इस्तेमाल के कुछ सामान्य उदाहरण दिए गए हैं.

एक्सटेंशन पेज को नए टैब में खोलें

जब एक्सटेंशन इंस्टॉल किया गया. नीचे दिए गए उदाहरण में इसका तरीका बताया गया है.

background.js:

chrome.runtime.onInstalled.addListener(({reason}) => {
  if (reason === 'install') {
    chrome.tabs.create({
      url: "onboarding.html"
    });
  }
});

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

ध्यान दें: इस उदाहरण के लिए, किसी भी अनुमति की ज़रूरत नहीं है.

मौजूदा टैब पर जाएं

यह उदाहरण दिखाता है कि किसी एक्सटेंशन का सर्विस वर्कर जिस विंडो पर फ़ोकस किया गया हो. अगर किसी Chrome विंडो पर फ़ोकस नहीं किया गया है, तो उस विंडो को चुनें. यह को आम तौर पर उपयोगकर्ता का मौजूदा टैब माना जा सकता है.

  async function getCurrentTab() {
    let queryOptions = { active: true, lastFocusedWindow: true };
    // `tab` will either be a `tabs.Tab` instance or `undefined`.
    let [tab] = await chrome.tabs.query(queryOptions);
    return tab;
  }

  function getCurrentTab(callback) {
    let queryOptions = { active: true, lastFocusedWindow: true };
    chrome.tabs.query(queryOptions, ([tab]) => {
      if (chrome.runtime.lastError)
      console.error(chrome.runtime.lastError);
      // `tab` will either be a `tabs.Tab` instance or `undefined`.
      callback(tab);
    });
  }

चुने गए टैब को म्यूट करें

इस उदाहरण में दिखाया गया है कि कोई एक्सटेंशन, दिए गए टैब के लिए म्यूट की गई स्थिति को कैसे टॉगल कर सकता है.

  async function toggleMuteState(tabId) {
    const tab = await chrome.tabs.get(tabId);
    const muted = !tab.mutedInfo.muted;
    await chrome.tabs.update(tabId, {muted});
    console.log(`Tab ${tab.id} is ${muted ? "muted" : "unmuted"}`);
  }

  function toggleMuteState(tabId) {
    chrome.tabs.get(tabId, async (tab) => {
      let muted = !tab.mutedInfo.muted;
      await chrome.tabs.update(tabId, { muted });
      console.log(`Tab ${tab.id} is ${ muted ? "muted" : "unmuted" }`);
    });
  }

क्लिक करने पर, मौजूदा टैब को पहली पोज़िशन पर ले जाएं

इस उदाहरण में, खींचकर छोड़ने के दौरान टैब को एक जगह से दूसरी जगह ले जाने का तरीका बताया गया है. हालांकि, यह उदाहरण chrome.tabs.move का इस्तेमाल करता है, तो टैब में बदलाव करने के लिए उसी वेटिंग पैटर्न का इस्तेमाल किया जा सकता है एक ड्रैग प्रोसेस में है.

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

  async function moveToFirstPosition(activeInfo) {
    try {
      await chrome.tabs.move(activeInfo.tabId, {index: 0});
      console.log("Success.");
    } catch (error) {
      if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
        setTimeout(() => moveToFirstPosition(activeInfo), 50);
      } else {
        console.error(error);
      }
    }
  }

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

अहम जानकारी: प्रॉमिस में कैच(गड़बड़ी) का इस्तेमाल करने से यह पक्का हो जाता है कि गड़बड़ी होने पर यह जानकारी अपने-आप जनरेट होती है: `chrome.runtime.lastError` से सही का निशान नहीं हटाया गया.

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

  function moveToFirstPositionMV2(activeInfo) {
    chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {
      if (chrome.runtime.lastError) {
        const error = chrome.runtime.lastError;
        if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
          setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);
        } else {
          console.error(error);
        }
      } else {
        console.log("Success.");
      }
    });
  }

किसी चुने गए टैब की कॉन्टेंट स्क्रिप्ट पर कोई मैसेज पास करें

यह उदाहरण दिखाता है कि किसी एक्सटेंशन का सर्विस वर्कर, tabs.sendMessage() का इस्तेमाल करके किसी खास ब्राउज़र टैब में कॉन्टेंट स्क्रिप्ट के साथ कैसे इंटरैक्ट कर सकता है.

function sendMessageToActiveTab(message) {
  const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
  const response = await chrome.tabs.sendMessage(tab.id, message);
  // TODO: Do something with the response.
}

एक्सटेंशन के उदाहरण

Tabs एपीआई एक्सटेंशन के ज़्यादा डेमो के लिए, इनमें से किसी एक को एक्सप्लोर करें:

• मेनिफ़ेस्ट V2 - Tabs API एक्सटेंशन.
• मेनिफ़ेस्ट V3 - टैब मैनेजर.

टाइप

MutedInfo

Chrome 46 और उसके बाद के वर्शन

टैब की म्यूट स्थिति और आखिरी बार स्थिति बदलने की वजह.

प्रॉपर्टी

• extensionId

  स्ट्रिंग ज़रूरी नहीं

  म्यूट किए गए स्टेटस को बदलने वाले एक्सटेंशन का आईडी. अगर म्यूट किए गए स्टेटस को आखिरी बार बदलने का कारण कोई एक्सटेंशन नहीं था, तो सेट नहीं किया गया.

• म्यूट किया गया

  बूलियन

  टैब को म्यूट किया गया है या नहीं (साउंड चलाने से रोका गया है). टैब म्यूट हो सकता है, भले ही वह चलाया न गया हो या अभी आवाज़ न चल रही हो. यह इस बात के बराबर है कि 'म्यूट किया गया' है या नहीं ऑडियो इंडिकेटर दिख रहा है.

• कारण

  MutedInfoReason ज़रूरी नहीं

  टैब को म्यूट या अनम्यूट किए जाने की वजह. अगर टैब की म्यूट स्थिति को कभी बदला नहीं गया है, तो सेट नहीं है.

MutedInfoReason

Chrome 46 और उसके बाद के वर्शन

वह इवेंट जिसकी वजह से 'म्यूट किया गया' स्टेटस बदल गया.

Enum

"user"
उपयोगकर्ता इनपुट की कार्रवाई ने म्यूट किया गया स्थिति सेट की.

"कैप्चर"
टैब कैप्चर करने की प्रोसेस शुरू की गई, ताकि म्यूट की गई स्थिति में बदलाव किया जा सके.

"एक्सटेंशन"
एक्सटेंशन आईडी फ़ील्ड से पहचाना जाने वाला एक एक्सटेंशन, म्यूट की गई स्थिति सेट करता है.

Tab

प्रॉपर्टी

• सक्रिय

  बूलियन

  टैब अपनी विंडो में चालू है या नहीं. इसका मतलब यह नहीं है कि विंडो फ़ोकस है.

• Audible

  बूलियन ज़रूरी नहीं

  Chrome 45+

  क्या टैब से पिछले कुछ सेकंड से आवाज़ आ रही है, लेकिन म्यूट करने पर हो सकता है कि वह सुनाई न दे. इस बात की बराबर है कि 'स्पीकर ऑडियो' इंडिकेटर दिख रहा है.

• autoDiscardable

  बूलियन

  Chrome 54 और उसके बाद वाले वर्शन के लिए

  क्या संसाधन कम होने पर, ब्राउज़र अपने-आप टैब को खारिज कर सकता है.

• खारिज किया गया

  बूलियन

  Chrome 54 और उसके बाद वाले वर्शन के लिए

  टैब को खारिज किया गया है या नहीं. खारिज किया गया टैब वह टैब होता है जिसका कॉन्टेंट, मेमोरी से अनलोड कर दिया गया हो, लेकिन वह टैब बार में अब भी दिख रहा हो. अगली बार चालू करने पर, इसका कॉन्टेंट फिर से लोड हो जाता है.

• favIconUrl

  स्ट्रिंग ज़रूरी नहीं

  टैब के फ़ेविकॉन का यूआरएल. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब एक्सटेंशन के मेनिफ़ेस्ट में "tabs" की अनुमति शामिल हो. अगर टैब लोड हो रहा है, तो वह खाली स्ट्रिंग भी हो सकती है.

• groupId

  संख्या

  Chrome 88 और उसके बाद के वर्शन

  उस ग्रुप का आईडी जिससे टैब जुड़ा है.

• ऊंचाई

  नंबर वैकल्पिक

  पिक्सल में टैब की ऊंचाई.

• हाइलाइट की गई

  बूलियन

  टैब हाइलाइट किया गया है या नहीं.

• आईडी

  नंबर वैकल्पिक

  टैब का आईडी. ब्राउज़र सेशन में टैब आईडी यूनीक होते हैं. कुछ मामलों में हो सकता है कि किसी टैब को आईडी असाइन न किया जाए; उदाहरण के लिए, sessions एपीआई का इस्तेमाल करके विदेशी टैब की क्वेरी करते समय, सेशन आईडी मौजूद हो सकता है. ऐप्लिकेशन और DevTools विंडो के लिए, टैब आईडी को chrome.tabs.TAB_ID_NONE पर भी सेट किया जा सकता है.

• गुप्त मोड

  बूलियन

  टैब गुप्त विंडो में है या नहीं.

• इंडेक्स

  संख्या

  विंडो में टैब का शून्य-आधारित इंडेक्स.

• lastAccessed

  संख्या

  Chrome 121 और उसके बाद वाले वर्शन

  Epoch के बाद के, मिलीसेकंड की संख्या के तौर पर पिछली बार टैब को ऐक्सेस किए जाने का समय.

• mutedInfo

  MutedInfo ज़रूरी नहीं

  Chrome 46 और उसके बाद के वर्शन

  टैब की म्यूट स्थिति और आखिरी बार स्थिति बदलने की वजह.

• openerTabId

  नंबर वैकल्पिक

  अगर इस टैब को खोलने के लिए इस्तेमाल किए गए टैब का कोई आईडी है, तो उस टैब का आईडी. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब ओपनर टैब अब भी मौजूद हो.

• pendingUrl

  स्ट्रिंग ज़रूरी नहीं

  Chrome 79 और उसके बाद के वर्शन

  वह यूआरएल जिस पर टैब नेविगेट किए जाने से पहले, इस्तेमाल किया जा रहा है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब एक्सटेंशन के मेनिफ़ेस्ट में "tabs" अनुमति शामिल हो और कोई नेविगेशन बाकी हो.

• पिन किया गया

  बूलियन

  टैब पिन किया गया है या नहीं.

• चुना गया

  बूलियन

  अब काम नहीं करता

  कृपया tabs.Tab.highlighted का इस्तेमाल करें.

  टैब को चुना गया है या नहीं.

• sessionId

  स्ट्रिंग ज़रूरी नहीं

  सेशन आईडी, जिसका इस्तेमाल sessions एपीआई से मिले टैब की खास तरह से पहचान करने के लिए किया जाता है.

• स्थिति

  TabStatus ज़रूरी नहीं

  टैब के लोड होने की स्थिति.

• title

  स्ट्रिंग ज़रूरी नहीं

  टैब का टाइटल. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब एक्सटेंशन के मेनिफ़ेस्ट में "tabs" की अनुमति शामिल हो.

• url

  स्ट्रिंग ज़रूरी नहीं

  यह टैब के मुख्य फ़्रेम का आखिरी यूआरएल होता है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब एक्सटेंशन के मेनिफ़ेस्ट में "tabs" की अनुमति शामिल हो. साथ ही, अगर टैब अभी तक काम नहीं करता है, तो यह एक खाली स्ट्रिंग हो सकती है. Tab.pendingUrl भी देखें.

• चौड़ाई

  नंबर वैकल्पिक

  पिक्सल में टैब की चौड़ाई.

• windowId

  संख्या

  उस विंडो का आईडी जिसमें टैब शामिल है.

TabStatus

Chrome 44 और उसके बाद वाले वर्शन के लिए

टैब के लोड होने की स्थिति.

Enum

"अनलोड किया गया"

"लोड हो रहा है"

"पूरा हुआ"

WindowType

Chrome 44 और उसके बाद वाले वर्शन के लिए

विंडो किस तरह की है.

Enum

"सामान्य"

"पॉपअप"

"पैनल"

"ऐप्लिकेशन"

"devtools"

ZoomSettings

यह तय करता है कि किसी टैब में, ज़ूम किए गए बदलावों को कैसे और किस दायरे में हैंडल किया जाता है.

प्रॉपर्टी

• defaultZoomFactor

  नंबर वैकल्पिक

  Chrome 43+

  इसका इस्तेमाल टैब टू कॉल में मौजूदा टैब के डिफ़ॉल्ट ज़ूम लेवल पर वापस जाने के लिए किया जाता है.getZoomSettings पर मौजूद है.

• मोड

  ZoomSettingsMode optional

  तय करता है कि ज़ूम से जुड़े बदलाव कैसे मैनेज किए जाते हैं. जैसे, पेज की असल स्केलिंग के लिए कौनसी इकाई ज़िम्मेदार है; डिफ़ॉल्ट रूप से automatic हो जाता है.

• दायरा

  ZoomSettingsScope ज़रूरी नहीं

  तय करता है कि ज़ूम में किए गए बदलाव, पेज के ऑरिजिन के लिए लागू रहेंगे या सिर्फ़ इस टैब में लागू होंगे; automatic मोड में होने पर डिफ़ॉल्ट तौर पर per-origin होता है, नहीं तो per-tab होता है.

ZoomSettingsMode

Chrome 44 और उसके बाद वाले वर्शन के लिए

तय करता है कि ज़ूम से जुड़े बदलाव कैसे मैनेज किए जाते हैं. जैसे, पेज की असल स्केलिंग के लिए कौनसी इकाई ज़िम्मेदार है; डिफ़ॉल्ट रूप से automatic हो जाता है.

Enum

"अपने-आप"
ज़ूम में होने वाले बदलावों को ब्राउज़र अपने-आप मैनेज करता है.

"मैन्युअल"
ज़ूम इन बदलावों को अपने-आप मैनेज करने की सुविधा को बदलता है. onZoomChange इवेंट अब भी भेजा जाएगा. इस इवेंट को सुनने और पेज को मैन्युअल तरीके से स्केल करने की ज़िम्मेदारी एक्सटेंशन की है. इस मोड में per-origin को ज़ूम नहीं किया जा सकता. इसलिए, यह scope ज़ूम सेटिंग को अनदेखा कर देता है और per-tab को मान लेता है.

"बंद"
इससे टैब पर ज़ूम इन करने की सभी सुविधाएं बंद हो जाती हैं. ऐसा करने से, टैब डिफ़ॉल्ट ज़ूम लेवल पर सेट हो जाता है और ज़ूम में किए गए सभी बदलाव नज़रअंदाज़ कर दिए जाते हैं.

ZoomSettingsScope

Chrome 44 और उसके बाद वाले वर्शन के लिए

तय करता है कि ज़ूम में किए गए बदलाव, पेज के ऑरिजिन के लिए लागू रहेंगे या सिर्फ़ इस टैब में लागू होंगे; automatic मोड में होने पर डिफ़ॉल्ट तौर पर per-origin होता है, नहीं तो per-tab होता है.

Enum

"हर ऑरिजिन"
ज़ूम किए गए पेज के ऑरिजिन में ज़ूम में बदलाव होते रहते हैं. इसका मतलब है कि उस ऑरिजिन पर जाने वाले दूसरे सभी टैब भी ज़ूम किए जाते हैं. इसके अलावा, ज़ूम में किए गए per-origin बदलाव, ऑरिजिन के साथ सेव किए जाते हैं. इसका मतलब है कि एक ही ऑरिजिन में दूसरे पेजों पर जाने पर, वे सभी एक ही ज़ूम फ़ैक्टर पर ज़ूम किए जाते हैं. per-origin स्कोप सिर्फ़ automatic मोड में उपलब्ध है.

"हर टैब"
ज़ूम में किए गए बदलाव सिर्फ़ इस टैब में लागू होते हैं. अन्य टैब में किए गए ज़ूम बदलावों से, इस टैब की ज़ूमिंग पर कोई असर नहीं पड़ता. साथ ही, नेविगेशन पर ज़ूम करने के per-tab बदलाव रीसेट होते हैं; किसी टैब पर नेविगेट करने पर, उसके per-origin ज़ूम फ़ैक्टर के साथ पेज हमेशा लोड होते हैं.

प्रॉपर्टी

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 और उसके बाद वाले वर्शन के लिए

captureVisibleTab को हर सेकंड ज़्यादा से ज़्यादा कितनी बार कॉल किया जा सकता है. captureVisibleTab महंगा है और इसे बार-बार कॉल नहीं करना चाहिए.

मान

2

TAB_ID_NONE

Chrome 46 और उसके बाद के वर्शन

यह ऐसा आईडी होता है जिससे पता चलता है कि ब्राउज़र टैब मौजूद नहीं है.

मान

-1

TAB_INDEX_NONE

Chrome 123 और उसके बाद वाले वर्शन

यह इंडेक्स करने से पता चलता है कि tab_strip में टैब इंडेक्स नहीं है.

मान

-1

तरीके

captureVisibleTab()

प्रॉमिस

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

तय विंडो में, मौजूदा चालू टैब के दिखने वाले हिस्से को कैप्चर करता है. इस तरीके को कॉल करने के लिए, एक्सटेंशन के पास <all_urls> अनुमति या activeTab अनुमति होनी चाहिए. इस तरीके का इस्तेमाल करने पर, एक्सटेंशन सामान्य तौर पर ऐक्सेस की जा सकने वाली साइटों के अलावा, ऐसी संवेदनशील साइटों को भी कैप्चर कर सकते हैं जिन पर पाबंदी लगी है. इनमें chrome:-scheme पेज और अन्य एक्सटेंशन शामिल हैं पेज, और डेटा: यूआरएल. इन संवेदनशील साइटों को सिर्फ़ ActiveTab की अनुमति के साथ ही कैप्चर किया जा सकता है. फ़ाइल के यूआरएल सिर्फ़ तब कैप्चर किए जा सकते हैं, जब एक्सटेंशन को फ़ाइल का ऐक्सेस दिया गया हो.

पैरामीटर

• windowId

  नंबर वैकल्पिक

  टारगेट विंडो. डिफ़ॉल्ट तौर पर, यह मौजूदा विंडो पर सेट होती है.

• विकल्प

  ImageDetails ज़रूरी नहीं

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (dataUrl: string) => void

  • dataUrl

    स्ट्रिंग

    ऐसा डेटा यूआरएल जो कैप्चर किए गए टैब के दिखने वाले हिस्से की इमेज को कोड में बदलता है. 'src' को असाइन किया जा सकता है दिखाने के लिए एचटीएमएल img एलिमेंट की प्रॉपर्टी.

रिटर्न

• प्रॉमिस<string>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

connect()

chrome.tabs.connect(
  tabId: number,
  connectInfo?: object,
)

बताए गए टैब में कॉन्टेंट स्क्रिप्ट से कनेक्ट करता है. मौजूदा एक्सटेंशन के लिए तय किए गए टैब में चल रही हर कॉन्टेंट स्क्रिप्ट में, runtime.onConnect इवेंट ट्रिगर होता है. ज़्यादा जानकारी के लिए, कॉन्टेंट स्क्रिप्ट मैसेजिंग देखें.

पैरामीटर

• tabId

  संख्या

• connectInfo

  ऑब्जेक्ट ज़रूरी नहीं

  • documentId

    स्ट्रिंग ज़रूरी नहीं

    Chrome 106 और उसके बाद वाले वर्शन

    टैब में मौजूद सभी फ़्रेम के बजाय, documentId से पहचाने गए किसी खास दस्तावेज़ के लिए पोर्ट खोलें.

  • frameId

    नंबर वैकल्पिक

    टैब में मौजूद सभी फ़्रेम के बजाय, frameId से पहचाने गए किसी खास फ़्रेम पर पोर्ट खोलें.

  • नाम

    स्ट्रिंग ज़रूरी नहीं

    कनेक्शन इवेंट को सुन रही कॉन्टेंट स्क्रिप्ट के लिए onConnect में पास किया जाता है.

रिटर्न

• runtime.Port

  वह पोर्ट जिसका इस्तेमाल तय किए गए टैब में चल रही कॉन्टेंट स्क्रिप्ट से संपर्क करने के लिए किया जा सकता है. अगर टैब बंद हो जाता है या मौजूद नहीं है, तो पोर्ट का runtime.Port इवेंट चालू हो जाता है.

create()

प्रॉमिस

chrome.tabs.create(
  createProperties: object,
  callback?: function,
)

नया टैब बनाता है.

पैरामीटर

• createProperties

  ऑब्जेक्ट

  • सक्रिय

    बूलियन ज़रूरी नहीं

    विंडो में, टैब को ऐक्टिव टैब में बदलना चाहिए या नहीं. इससे विंडो के फ़ोकस पर असर नहीं पड़ता (windows.update देखें). डिफ़ॉल्ट तौर पर, यह true पर सेट होता है.

  • इंडेक्स

    नंबर वैकल्पिक

    वह जगह जिसे टैब को विंडो में रखना चाहिए. दी गई वैल्यू को शून्य और विंडो में टैब की संख्या के बीच में रखा जाता है.

  • openerTabId

    नंबर वैकल्पिक

    उस टैब का आईडी जिसने यह टैब खोला था. अगर बताया गया हो, तो ओपनर टैब उसी विंडो में होना चाहिए जिसमें नया टैब बनाया गया है.

  • पिन किया गया

    बूलियन ज़रूरी नहीं

    टैब को पिन किया जाना चाहिए या नहीं. डिफ़ॉल्ट तौर पर, false

  • चुना गया

    बूलियन ज़रूरी नहीं

    अब काम नहीं करता

    कृपया चालू है का इस्तेमाल करें.

    टैब को, विंडो में चुना गया टैब बनना चाहिए या नहीं. डिफ़ॉल्ट तौर पर, true

  • url

    स्ट्रिंग ज़रूरी नहीं

    वह यूआरएल जिस पर शुरुआत में टैब को नेविगेट करना है. पूरी तरह क्वालिफ़ाइड यूआरएल में, एक स्कीम शामिल होनी चाहिए. जैसे, 'http://www.google.com' डालें, न कि 'www.google.com'). मिलते-जुलते यूआरएल, एक्सटेंशन में मौजूदा पेज से जुड़े होते हैं. डिफ़ॉल्ट रूप से, यह 'नया टैब' पेज पर सेट होता है.

  • windowId

    नंबर वैकल्पिक

    वह विंडो जिसमें नया टैब बनाना है. डिफ़ॉल्ट तौर पर, यह मौजूदा विंडो पर सेट होती है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (tab: Tab) => void

  • टैब

    टैब

    बनाया गया टैब.

रिटर्न

• प्रॉमिस<Tab>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

detectLanguage()

प्रॉमिस

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

टैब में कॉन्टेंट की मुख्य भाषा का पता लगाता है.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  डिफ़ॉल्ट रूप से, यह मौजूदा विंडो के ऐक्टिव टैब में सेट होती है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (language: string) => void

  • भाषा

    स्ट्रिंग

    ISO भाषा कोड, जैसे कि en या fr. इस तरीके से काम करने वाली भाषाओं की पूरी सूची के लिए, kLanguageInfoTable देखें. दूसरे से चौथे कॉलम की जांच की जाती है और पहला बिना शून्य वाली वैल्यू दिखाई जाती है. हालांकि, सिंप्लिफ़ाइड चाइनीज़ के लिए, जिसके लिए zh-CN दिखाया जाता है. ऐसी भाषा के लिए und दिखाया जाता है जिसकी जानकारी नहीं है या जो तय नहीं है.

रिटर्न

• प्रॉमिस<string>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

discard()

प्रॉमिस Chrome 54 और उसके बाद वाले वर्शन के लिए

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

'यादें' से टैब को खारिज करता है. हटाए गए टैब, टैब बार पर अब भी दिखते हैं और चालू होने पर उन्हें फिर से लोड किया जाता है.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  खारिज किए जाने वाले टैब का आईडी. तय किए जाने पर, टैब को तब तक खारिज कर दिया जाता है, जब तक कि वह चालू न हो या पहले ही खारिज कर दिया गया हो. अगर इसे छोड़ा जाता है, तो ब्राउज़र सबसे कम ज़रूरी टैब को खारिज कर देता है. खारिज करने लायक कोई टैब मौजूद न होने पर, ऐसा हो सकता है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (tab?: Tab) => void

  • टैब

    टैब ज़रूरी नहीं

    खारिज किया गया टैब, अगर उसे खारिज कर दिया गया था; तय नहीं है.

रिटर्न

• वादा<टैब | तय नहीं है>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

duplicate()

प्रॉमिस

chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)

टैब का डुप्लीकेट बनाता है.

पैरामीटर

• tabId

  संख्या

  डुप्लीकेट करने के लिए टैब का आईडी.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (tab?: Tab) => void

  • टैब

    टैब ज़रूरी नहीं

    डुप्लीकेट किए गए टैब के बारे में जानकारी. अगर "tabs" की अनुमति का अनुरोध नहीं किया गया है, तो tabs.Tab ऑब्जेक्ट में url, pendingUrl, title, और favIconUrl शामिल नहीं हैं.

रिटर्न

• वादा<टैब | तय नहीं है>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

executeScript()

प्रॉमिस &amp;leq; MV2 Chrome 91 के बाद से अब तक काम नहीं करता

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

मेनिफ़ेस्ट V3 में scripting.executeScript से बदला गया.

किसी पेज में JavaScript कोड इंजेक्ट करता है. ज़्यादा जानकारी के लिए, कॉन्टेंट स्क्रिप्ट दस्तावेज़ का प्रोग्रामैटिक इंजेक्शन सेक्शन देखें.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  उस टैब का आईडी, जिसमें स्क्रिप्ट चलाना है; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.

• विवरण

  InjectDetails

  चलाने के लिए स्क्रिप्ट की जानकारी. कोड या फ़ाइल प्रॉपर्टी में से किसी एक को सेट करना ज़रूरी है, लेकिन दोनों को एक साथ सेट नहीं किया जा सकता.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (result?: any[]) => void

  • नतीजा

    कोई भी[] ज़रूरी नहीं

    हर इंजेक्ट किए गए फ़्रेम में स्क्रिप्ट का नतीजा.

रिटर्न

• Promise&lt;any[] | तय नहीं है>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

get()

प्रॉमिस

chrome.tabs.get(
  tabId: number,
  callback?: function,
)

चुने गए टैब के बारे में जानकारी हासिल करता है.

पैरामीटर

• tabId

  संख्या

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (tab: Tab) => void

  • टैब

    टैब

रिटर्न

• प्रॉमिस<Tab>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

getAllInWindow()

प्रॉमिस &amp;leq; MV2 अब काम नहीं करता

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

कृपया tabs.query {windowId: windowId} का इस्तेमाल करें.

बताई गई विंडो के सभी टैब की जानकारी दिखाता है.

पैरामीटर

• windowId

  नंबर वैकल्पिक

  डिफ़ॉल्ट तौर पर, यह मौजूदा विंडो पर सेट होती है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (tabs: Tab[]) => void

  • टैब

    टैब[]

रिटर्न

• प्रॉमिस<टैब[]>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

getCurrent()

प्रॉमिस

chrome.tabs.getCurrent(
  callback?: function,
)

इस नीति से उस टैब की जानकारी मिलती है जिससे यह स्क्रिप्ट कॉल किया जा रहा है. बिना टैब वाले कॉन्टेक्स्ट (जैसे, बैकग्राउंड पेज या पॉप-अप व्यू) से कॉल किए जाने पर, undefined दिखाता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (tab?: Tab) => void

  • टैब

    टैब ज़रूरी नहीं

रिटर्न

• वादा<टैब | तय नहीं है>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

getSelected()

प्रॉमिस &amp;leq; MV2 अब काम नहीं करता

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

कृपया tabs.query {active: true} का इस्तेमाल करें.

तय विंडो में चुने गए टैब पर क्लिक करता है.

पैरामीटर

• windowId

  नंबर वैकल्पिक

  डिफ़ॉल्ट तौर पर, यह मौजूदा विंडो पर सेट होती है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (tab: Tab) => void

  • टैब

    टैब

रिटर्न

• प्रॉमिस<Tab>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

getZoom()

प्रॉमिस

chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
)

किसी खास टैब के मौजूदा ज़ूम फ़ैक्टर की जानकारी देता है.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  मौजूदा ज़ूम फ़ैक्टर पाने के लिए, टैब का आईडी; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (zoomFactor: number) => void

  • zoomFactor

    संख्या

    टैब का मौजूदा ज़ूम फ़ैक्टर.

रिटर्न

• Promise&lt;number&gt;

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

getZoomSettings()

प्रॉमिस

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)

किसी खास टैब की मौजूदा ज़ूम सेटिंग लागू करता है.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  मौजूदा ज़ूम सेटिंग पाने के लिए, टैब का आईडी; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (zoomSettings: ZoomSettings) => void

  • zoomSettings

    ZoomSettings

    टैब की मौजूदा ज़ूम सेटिंग.

रिटर्न

• Promise&lt;ZoomSettings&gt;

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

goBack()

प्रॉमिस Chrome 72 और उसके बाद वाले वर्शन के लिए

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

अगर कोई पेज उपलब्ध है, तो पिछले पेज पर वापस जाएं.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  वापस नेविगेट करने के लिए टैब का आईडी; मौजूदा विंडो के चुने गए टैब पर डिफ़ॉल्ट रूप से सेट होता है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

goForward()

प्रॉमिस Chrome 72 और उसके बाद वाले वर्शन के लिए

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

अगर कोई पेज उपलब्ध है, तो अगले पेज पर जाएं.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  आगे की ओर नेविगेट करने के लिए टैब का आईडी; मौजूदा विंडो के चुने गए टैब पर डिफ़ॉल्ट रूप से सेट होता है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

group()

प्रॉमिस Chrome 88 और उसके बाद वाले वर्शन के लिए

chrome.tabs.group(
  options: object,
  callback?: function,
)

किसी चुने गए ग्रुप में एक या उससे ज़्यादा टैब जोड़ता है या अगर कोई ग्रुप नहीं चुना गया है, तो दिए गए टैब को नए बनाए गए ग्रुप में जोड़ देता है.

पैरामीटर

• विकल्प

  ऑब्जेक्ट

  • createProperties

    ऑब्जेक्ट ज़रूरी नहीं

    ग्रुप बनाने के लिए कॉन्फ़िगरेशन. अगर groupId पहले से तय किया गया है, तो इसका इस्तेमाल नहीं किया जा सकता.

    • windowId

      नंबर वैकल्पिक

      नए ग्रुप की विंडो. डिफ़ॉल्ट तौर पर, यह मौजूदा विंडो पर सेट होती है.

  • groupId

    नंबर वैकल्पिक

    उस ग्रुप का आईडी जिसमें टैब जोड़ना है. अगर इसके बारे में नहीं बताया गया, तो एक नया ग्रुप बना दिया जाएगा.

  • tabIds

    नंबर | [नंबर, ...संख्या[]]

    किसी खास ग्रुप में जोड़ने के लिए, टैब आईडी या टैब आईडी की सूची.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (groupId: number) => void

  • groupId

    संख्या

    उस ग्रुप का आईडी जिसमें टैब जोड़े गए थे.

रिटर्न

• Promise&lt;number&gt;

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

highlight()

प्रॉमिस

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

दिए गए टैब को हाइलाइट करता है और ग्रुप के पहले आइटम पर फ़ोकस करता है. अगर बताया गया टैब अभी चालू है, तो 'कुछ नहीं करता' दिखेगा.

पैरामीटर

• highlightInfo

  ऑब्जेक्ट

  • टैब

    नंबर | नंबर[]

    हाइलाइट करने के लिए एक या उससे ज़्यादा टैब इंडेक्स.

  • windowId

    नंबर वैकल्पिक

    वह विंडो जिसमें टैब होते हैं.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (window: Window) => void

  • विंडो

    विंडो

    इसमें उस विंडो के बारे में जानकारी होती है जिसके टैब हाइलाइट किए गए थे.

रिटर्न

• Promise&lt;windows.Window&gt;

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

insertCSS()

प्रॉमिस &amp;leq; MV2 Chrome 91 के बाद से अब तक काम नहीं करता

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

मेनिफ़ेस्ट V3 में scripting.insertCSS से बदला गया.

सीएसएस को पेज में इंजेक्ट करता है. इस तरीके का इस्तेमाल करके डाली गई स्टाइल को scripting.removeCSS की मदद से हटाया जा सकता है. ज़्यादा जानकारी के लिए, कॉन्टेंट स्क्रिप्ट दस्तावेज़ का प्रोग्रामैटिक इंजेक्शन सेक्शन देखें.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  उस टैब का आईडी, जिसमें सीएसएस डालना है; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.

• विवरण

  InjectDetails

  शामिल किए जाने वाले सीएसएस टेक्स्ट की जानकारी. कोड या फ़ाइल प्रॉपर्टी में से किसी एक को सेट करना ज़रूरी है, लेकिन दोनों को एक साथ सेट नहीं किया जा सकता.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

move()

प्रॉमिस

chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
  callback?: function,
)

एक या ज़्यादा टैब को उसकी विंडो में या नई विंडो पर ले जाता है. ध्यान दें कि टैब को सिर्फ़ सामान्य (window.type === "normal") विंडो पर और उससे दूसरी विंडो में ले जाया जा सकता है.

पैरामीटर

• tabIds

  नंबर | नंबर[]

  दूसरी जगह ले जाने के लिए, टैब आईडी या टैब आईडी की सूची.

• moveProperties

  ऑब्जेक्ट

  • इंडेक्स

    संख्या

    वह जगह जहां विंडो को ले जाना है. टैब को विंडो के आखिर में रखने के लिए, -1 का इस्तेमाल करें.

  • windowId

    नंबर वैकल्पिक

    डिफ़ॉल्ट रूप से उस विंडो को मिलता है जिसमें टैब अभी मौजूद है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (tabs: Tab | Tab[]) => void

  • टैब

    टैब | टैब[]

    दूसरी जगह ले जाए गए टैब के बारे में जानकारी.

रिटर्न

• वादा<टैब | टैब[]>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

query()

प्रॉमिस

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

तय प्रॉपर्टी वाले सभी टैब दिखाता है या अगर कोई प्रॉपर्टी नहीं दी गई है, तो सभी टैब लेता है.

पैरामीटर

• queryInfo

  ऑब्जेक्ट

  • सक्रिय

    बूलियन ज़रूरी नहीं

    उनकी विंडो में टैब चालू हैं या नहीं.

  • Audible

    बूलियन ज़रूरी नहीं

    Chrome 45+

    टैब सुने जा सकते हैं या नहीं.

  • autoDiscardable

    बूलियन ज़रूरी नहीं

    Chrome 54 और उसके बाद वाले वर्शन के लिए

    क्या संसाधन कम होने पर, ब्राउज़र अपने-आप टैब खारिज कर सकता है.

  • currentWindow

    बूलियन ज़रूरी नहीं

    मौजूदा विंडो में टैब मौजूद हैं या नहीं.

  • खारिज किया गया

    बूलियन ज़रूरी नहीं

    Chrome 54 और उसके बाद वाले वर्शन के लिए

    क्या टैब खारिज किए गए हैं. खारिज किया गया टैब वह टैब होता है जिसका कॉन्टेंट, मेमोरी से अनलोड कर दिया गया हो, लेकिन वह टैब बार में अब भी दिख रहा हो. अगली बार चालू करने पर, इसका कॉन्टेंट फिर से लोड हो जाता है.

  • groupId

    नंबर वैकल्पिक

    Chrome 88 और उसके बाद के वर्शन

    उस ग्रुप का आईडी जिसमें टैब हैं या ग्रुप से बाहर रखे गए टैब के लिए, tabGroups.TAB_GROUP_ID_NONE.

  • हाइलाइट की गई

    बूलियन ज़रूरी नहीं

    टैब हाइलाइट किए गए हैं या नहीं.

  • इंडेक्स

    नंबर वैकल्पिक

    उनकी विंडो में टैब की स्थिति.

  • lastFocusedWindow

    बूलियन ज़रूरी नहीं

    टैब, पिछली बार फ़ोकस की गई विंडो में हैं या नहीं.

  • म्यूट किया गया

    बूलियन ज़रूरी नहीं

    Chrome 45+

    टैब म्यूट हैं या नहीं.

  • पिन किया गया

    बूलियन ज़रूरी नहीं

    टैब पिन किए गए हैं या नहीं.

  • स्थिति

    TabStatus ज़रूरी नहीं

    टैब लोड होने की स्थिति.

  • title

    स्ट्रिंग ज़रूरी नहीं

    किसी पैटर्न के हिसाब से पेज के टाइटल का मिलान करें. अगर एक्सटेंशन के पास "tabs" की अनुमति नहीं है, तो इस प्रॉपर्टी को अनदेखा किया जाता है.

  • url

    string | स्ट्रिंग[] ज़रूरी नहीं

    टैब को एक या उससे ज़्यादा यूआरएल पैटर्न के साथ मैच करें. फ़्रैगमेंट आइडेंटिफ़ायर मैच नहीं करते. अगर एक्सटेंशन के पास "tabs" की अनुमति नहीं है, तो इस प्रॉपर्टी को अनदेखा किया जाता है.

  • windowId

    नंबर वैकल्पिक

    पैरंट विंडो का आईडी या मौजूदा विंडो के लिए, windows.WINDOW_ID_CURRENT.

  • windowType

    WindowType वैकल्पिक

    उस विंडो का टाइप जिसमें टैब हैं.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (result: Tab[]) => void

  • नतीजा

    टैब[]

रिटर्न

• प्रॉमिस<टैब[]>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

reload()

प्रॉमिस

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

टैब को फिर से लोड करें.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  फिर से लोड किए जाने वाले टैब का आईडी; मौजूदा विंडो के चुने गए टैब पर डिफ़ॉल्ट रूप से सेट होता है.

• reloadProperties

  ऑब्जेक्ट ज़रूरी नहीं

  • bypassCache

    बूलियन ज़रूरी नहीं

    क्या डिवाइस को कैश मेमोरी में सेव करने की प्रोसेस को बायपास करना है. डिफ़ॉल्ट तौर पर, यह false पर सेट होता है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

remove()

प्रॉमिस

chrome.tabs.remove(
  tabIds: number | number[],
  callback?: function,
)

एक या उससे ज़्यादा टैब बंद करता है.

पैरामीटर

• tabIds

  नंबर | नंबर[]

  बंद किए जाने वाले टैब आईडी या टैब आईडी की सूची.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

removeCSS()

प्रॉमिस Chrome 87 और उसके बाद वाले वर्शन के लिए &amp;leq; MV2 Chrome 91 के बाद से अब तक काम नहीं करता

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

मेनिफ़ेस्ट V3 में scripting.removeCSS से बदला गया.

उस पेज सीएसएस से हटाता है जिसे पहले scripting.insertCSS पर कॉल करके डाला गया था.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  उस टैब का आईडी जिससे सीएसएस हटाना है; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.

• विवरण

  DeleteInjectionDetails

  हटाए जाने वाले सीएसएस टेक्स्ट की जानकारी. कोड या फ़ाइल प्रॉपर्टी में से किसी एक को सेट करना ज़रूरी है, लेकिन दोनों को एक साथ सेट नहीं किया जा सकता.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

sendMessage()

प्रॉमिस

chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
)

यह तय किए गए टैब में मौजूद कॉन्टेंट स्क्रिप्ट पर एक मैसेज भेजता है. साथ ही, रिस्पॉन्स के वापस भेजे जाने पर, वैकल्पिक कॉलबैक को चलाता है. मौजूदा एक्सटेंशन के लिए तय किए गए टैब में चल रही हर कॉन्टेंट स्क्रिप्ट में, runtime.onMessage इवेंट ट्रिगर होता है.

पैरामीटर

• tabId

  संख्या

• मैसेज

  कोई

  भेजा जाने वाला मैसेज. यह मैसेज एक ऐसा ऑब्जेक्ट होना चाहिए जिसे JSON फ़ॉर्मैट किया जा सके.

• विकल्प

  ऑब्जेक्ट ज़रूरी नहीं

  • documentId

    स्ट्रिंग ज़रूरी नहीं

    Chrome 106 और उसके बाद वाले वर्शन

    टैब में मौजूद सभी फ़्रेम के बजाय, documentId से पहचाने गए किसी खास दस्तावेज़ पर मैसेज भेजें.

  • frameId

    नंबर वैकल्पिक

    टैब में सभी फ़्रेम के बजाय, frameId से पहचाने गए किसी खास फ़्रेम पर मैसेज भेजें.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  Chrome 99 या इसके बाद के वर्शन

  callback पैरामीटर ऐसा दिखता है:

  (response: any) => void

  • जवाब

    कोई

    मैसेज के हैंडलर से भेजा गया JSON रिस्पॉन्स ऑब्जेक्ट. अगर बताए गए टैब से कनेक्ट करते समय कोई गड़बड़ी होती है, तो कॉलबैक को बिना किसी आर्ग्युमेंट के कॉल किया जाता है और runtime.lastError को गड़बड़ी के मैसेज पर सेट किया जाता है.

रिटर्न

• वादा करें<किसी भी>

  Chrome 99 या इसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

sendRequest()

प्रॉमिस &amp;leq; MV2 अब काम नहीं करता

chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)

कृपया runtime.sendMessage का इस्तेमाल करें.

यह तय किए गए टैब में, कॉन्टेंट स्क्रिप्ट को एक अनुरोध भेजता है. साथ ही, रिस्पॉन्स के वापस भेजे जाने पर, वैकल्पिक कॉलबैक के साथ भी यह काम करता है. मौजूदा एक्सटेंशन के लिए तय किए गए टैब में चल रही हर कॉन्टेंट स्क्रिप्ट में, extension.onRequest इवेंट ट्रिगर होता है.

पैरामीटर

• tabId

  संख्या

• CANNOT TRANSLATE

  कोई

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  Chrome 99 या इसके बाद के वर्शन

  callback पैरामीटर ऐसा दिखता है:

  (response: any) => void

  • जवाब

    कोई

    अनुरोध के हैंडलर से भेजा गया JSON रिस्पॉन्स ऑब्जेक्ट. अगर बताए गए टैब से कनेक्ट करते समय कोई गड़बड़ी होती है, तो कॉलबैक को बिना किसी आर्ग्युमेंट के कॉल किया जाता है और runtime.lastError को गड़बड़ी के मैसेज पर सेट किया जाता है.

रिटर्न

• वादा करें<किसी भी>

  Chrome 99 या इसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setZoom()

प्रॉमिस

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

किसी टैब को ज़ूम करता है.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  ज़ूम करने के लिए टैब का आईडी; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.

• zoomFactor

  संख्या

  नया ज़ूम फ़ैक्टर. 0 की वैल्यू, टैब को उसके मौजूदा डिफ़ॉल्ट ज़ूम फ़ैक्टर पर सेट करती है. 0 से बड़ी वैल्यू, टैब के लिए ज़ूम फ़ैक्टर की जानकारी देती है. ऐसा हो सकता है कि यह डिफ़ॉल्ट तौर पर सेट न हो.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setZoomSettings()

प्रॉमिस

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

किसी खास टैब के लिए, ज़ूम की सेटिंग सेट करता है. इससे ज़ूम में होने वाले बदलावों को मैनेज करने का तरीका पता चलता है. टैब पर नेविगेट करने पर ये सेटिंग डिफ़ॉल्ट पर रीसेट हो जाती हैं.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  उस टैब का आईडी जिसके लिए ज़ूम सेटिंग बदलनी है; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.

• zoomSettings

  ZoomSettings

  यह तय करता है कि ज़ूम में किए गए बदलाव कैसे हैंडल किए जाते हैं और किस दायरे में किए जाते हैं.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

ungroup()

प्रॉमिस Chrome 88 और उसके बाद वाले वर्शन के लिए

chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
)

अपने ग्रुप से एक या उससे ज़्यादा टैब हटा देता है. अगर कोई ग्रुप खाली हो जाता है, तो उसे मिटा दिया जाता है.

पैरामीटर

• tabIds

  नंबर | [नंबर, ...संख्या[]]

  ग्रुप से हटाए जाने वाले टैब आईडी या टैब आईडी की सूची.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

update()

प्रॉमिस

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
)

टैब की प्रॉपर्टी में बदलाव करता है. जिन प्रॉपर्टी की जानकारी updateProperties में नहीं दी गई है उनमें बदलाव नहीं किया गया है.

पैरामीटर

• tabId

  नंबर वैकल्पिक

  मौजूदा विंडो के चुने गए टैब पर डिफ़ॉल्ट रूप से सेट होती है.

• updateProperties

  ऑब्जेक्ट

  • सक्रिय

    बूलियन ज़रूरी नहीं

    टैब को चालू करना है या नहीं. इससे विंडो के फ़ोकस पर असर नहीं पड़ता (windows.update देखें).

  • autoDiscardable

    बूलियन ज़रूरी नहीं

    Chrome 54 और उसके बाद वाले वर्शन के लिए

    संसाधन कम होने पर, ब्राउज़र को टैब को अपने-आप खारिज कर देना चाहिए या नहीं.

  • हाइलाइट की गई

    बूलियन ज़रूरी नहीं

    मौजूदा चुने गए टैब में से टैब को जोड़ता है या उससे हटाता है.

  • म्यूट किया गया

    बूलियन ज़रूरी नहीं

    Chrome 45+

    टैब को म्यूट किया जाना चाहिए या नहीं.

  • openerTabId

    नंबर वैकल्पिक

    उस टैब का आईडी जिसने यह टैब खोला था. अगर तय किया गया है, तो ओपनर टैब उसी विंडो में होना चाहिए जिसमें इस टैब मौजूद है.

  • पिन किया गया

    बूलियन ज़रूरी नहीं

    टैब को पिन किया जाना चाहिए या नहीं.

  • चुना गया

    बूलियन ज़रूरी नहीं

    अब काम नहीं करता

    कृपया हाइलाइट किए गए का इस्तेमाल करें.

    टैब को चुना जाना चाहिए या नहीं.

  • url

    स्ट्रिंग ज़रूरी नहीं

    वह यूआरएल जिस पर टैब को नेविगेट करना है. JavaScript यूआरएल इस्तेमाल नहीं किए जा सकते; इसके बजाय, scripting.executeScript का इस्तेमाल करें.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (tab?: Tab) => void

  • टैब

    टैब ज़रूरी नहीं

    अपडेट किए गए टैब के बारे में जानकारी. अगर "tabs" की अनुमति का अनुरोध नहीं किया गया है, तो tabs.Tab ऑब्जेक्ट में url, pendingUrl, title, और favIconUrl शामिल नहीं हैं.

रिटर्न

• वादा<टैब | तय नहीं है>

  Chrome 88 और उसके बाद के वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

इवेंट

onActivated

chrome.tabs.onActivated.addListener(
  callback: function,
)

किसी विंडो में ऐक्टिव टैब के बदलने पर सक्रिय होता है. ध्यान दें, हो सकता है कि इस इवेंट के सक्रिय होने पर टैब का यूआरएल सेट न हो, लेकिन अपडेट किए गए इवेंट सुने जा सकते हैं, ताकि यूआरएल सेट होने पर आपको सूचना दी जा सके.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (activeInfo: object) => void

  • activeInfo

    ऑब्जेक्ट

    • tabId

      संख्या

      उस टैब का आईडी जो चालू हो गया है.

    • windowId

      संख्या

      उस विंडो का आईडी जिसके अंदर ऐक्टिव टैब बदला गया.

onActiveChanged

&amp;leq; MV2 अब काम नहीं करता

chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

कृपया tabs.onActivated का इस्तेमाल करें.

किसी विंडो में चुना गया टैब बदलने पर सक्रिय होता है. ध्यान दें, हो सकता है कि इस इवेंट के ट्रिगर होने पर टैब का यूआरएल सेट न हो. हालांकि, tabs.onUpdated इवेंट को सुना जा सकता है, ताकि यूआरएल सेट होने पर आपको सूचना दी जा सके.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (tabId: number, selectInfo: object) => void

  • tabId

    संख्या

  • selectInfo

    ऑब्जेक्ट

    • windowId

      संख्या

      उस विंडो का आईडी जिसके ज़रिए चुना गया टैब बदल गया.

onAttached

chrome.tabs.onAttached.addListener(
  callback: function,
)

तब ट्रिगर होता है, जब विंडो से टैब जुड़ा होता है; क्योंकि उसे एक विंडो से दूसरी विंडो में ले जाया गया था.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (tabId: number, attachInfo: object) => void

  • tabId

    संख्या

  • attachInfo

    ऑब्जेक्ट

    • newPosition

      संख्या

    • newWindowId

      संख्या

onCreated

chrome.tabs.onCreated.addListener(
  callback: function,
)

यह टैब बनाए जाने पर सक्रिय होता है. ध्यान दें, ऐसा हो सकता है कि इस इवेंट के चालू होते समय, टैब का यूआरएल और टैब ग्रुप की सदस्यता सेट न हो. हालांकि, अपडेट किए गए इवेंट सुने जा सकते हैं, ताकि यूआरएल सेट होने या टैब ग्रुप में टैब जोड़े जाने पर आपको सूचना दी जा सके.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (tab: Tab) => void

  • टैब

    टैब

onDetached

chrome.tabs.onDetached.addListener(
  callback: function,
)

टैब को विंडो से अलग किए जाने पर सक्रिय होता है; क्योंकि उसे एक विंडो से दूसरी विंडो में ले जाया गया था.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (tabId: number, detachInfo: object) => void

  • tabId

    संख्या

  • detachInfo

    ऑब्जेक्ट

    • oldPosition

      संख्या

    • oldWindowId

      संख्या

onHighlightChanged

&amp;leq; MV2 अब काम नहीं करता

chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

कृपया tabs.onHighlighted का इस्तेमाल करें.

किसी विंडो में हाइलाइट किए गए या चुने गए टैब में बदलाव होने पर सक्रिय होता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (selectInfo: object) => void

  • selectInfo

    ऑब्जेक्ट

    • tabIds

      नंबर[]

      विंडो में हाइलाइट किए गए सभी टैब.

    • windowId

      संख्या

      वह विंडो जिसके टैब बदल गए थे.

onHighlighted

chrome.tabs.onHighlighted.addListener(
  callback: function,
)

किसी विंडो में हाइलाइट किए गए या चुने गए टैब में बदलाव होने पर सक्रिय होता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (highlightInfo: object) => void

  • highlightInfo

    ऑब्जेक्ट

    • tabIds

      नंबर[]

      विंडो में हाइलाइट किए गए सभी टैब.

    • windowId

      संख्या

      वह विंडो जिसके टैब बदल गए थे.

onMoved

chrome.tabs.onMoved.addListener(
  callback: function,
)

टैब को विंडो में ले जाने पर ट्रिगर होता है. सिर्फ़ एक मूव इवेंट ट्रिगर होता है. यह उस टैब को दिखाता है जिसे उपयोगकर्ता सीधे मूव करता है. दूसरी जगह ले जाने वाले इवेंट उन दूसरे टैब के लिए चालू नहीं होते जिन्हें मैन्युअल तरीके से एक से दूसरे टैब पर ले जाने की वजह से अलग-अलग टैब पर जाना पड़ता है. टैब को एक से दूसरी विंडो में ले जाने पर यह इवेंट ट्रिगर नहीं होता; ज़्यादा जानकारी के लिए, tabs.onDetached देखें.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (tabId: number, moveInfo: object) => void

  • tabId

    संख्या

  • moveInfo

    ऑब्जेक्ट

    • fromIndex

      संख्या

    • toIndex

      संख्या

    • windowId

      संख्या

onRemoved

chrome.tabs.onRemoved.addListener(
  callback: function,
)

यह टैब बंद होने पर ट्रिगर होता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (tabId: number, removeInfo: object) => void

  • tabId

    संख्या

  • removeInfo

    ऑब्जेक्ट

    • isWindowClosing

      बूलियन

      सही है, जब टैब बंद किया गया था, क्योंकि उसकी पैरंट विंडो बंद थी.

    • windowId

      संख्या

      वह विंडो जिसका टैब बंद है.

onReplaced

chrome.tabs.onReplaced.addListener(
  callback: function,
)

प्रीरेंडरिंग या झटपट दिखने की वजह से, किसी टैब को दूसरे टैब से बदले जाने पर ट्रिगर होता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (addedTabId: number, removedTabId: number) => void

  • addedTabId

    संख्या

  • removedTabId

    संख्या

onSelectionChanged

&amp;leq; MV2 अब काम नहीं करता

chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

कृपया tabs.onActivated का इस्तेमाल करें.

किसी विंडो में चुना गया टैब बदलने पर सक्रिय होता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (tabId: number, selectInfo: object) => void

  • tabId

    संख्या

  • selectInfo

    ऑब्जेक्ट

    • windowId

      संख्या

      उस विंडो का आईडी जिसके ज़रिए चुना गया टैब बदल गया.

onUpdated

chrome.tabs.onUpdated.addListener(
  callback: function,
)

टैब अपडेट होने पर ट्रिगर होता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (tabId: number, changeInfo: object, tab: Tab) => void

  • tabId

    संख्या

  • changeInfo

    ऑब्जेक्ट

    • Audible

      बूलियन ज़रूरी नहीं

      Chrome 45+

      टैब की सुनी जा सकने वाली नई स्थिति.

    • autoDiscardable

      बूलियन ज़रूरी नहीं

      Chrome 54 और उसके बाद वाले वर्शन के लिए

      टैब की नई अपने-आप मिटने वाली स्थिति.

    • खारिज किया गया

      बूलियन ज़रूरी नहीं

      Chrome 54 और उसके बाद वाले वर्शन के लिए

      टैब की नई खारिज की गई स्थिति.

    • favIconUrl

      स्ट्रिंग ज़रूरी नहीं

      टैब का नया फ़ेविकॉन यूआरएल.

    • groupId

      नंबर वैकल्पिक

      Chrome 88 और उसके बाद के वर्शन

      टैब का नया ग्रुप.

    • mutedInfo

      MutedInfo ज़रूरी नहीं

      Chrome 46 और उसके बाद के वर्शन

      टैब की म्यूट की गई नई स्थिति और बदलाव की वजह.

    • पिन किया गया

      बूलियन ज़रूरी नहीं

      टैब की पिन की गई नई स्थिति.

    • स्थिति

      TabStatus ज़रूरी नहीं

      टैब के लोड होने की स्थिति.

    • title

      स्ट्रिंग ज़रूरी नहीं

      Chrome 48 और उसके बाद वाले वर्शन के लिए

      टैब का नया टाइटल.

    • url

      स्ट्रिंग ज़रूरी नहीं

      अगर टैब का यूआरएल बदल गया है.

  • टैब

    टैब

onZoomChange

chrome.tabs.onZoomChange.addListener(
  callback: function,
)

टैब ज़ूम किए जाने पर सक्रिय होता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  callback पैरामीटर ऐसा दिखता है:

  (ZoomChangeInfo: object) => void

  • ZoomChangeInfo

    ऑब्जेक्ट

    • newZoomFactor

      संख्या

    • oldZoomFactor

      संख्या

    • tabId

      संख्या

    • zoomSettings

      ZoomSettings