ब्यौरा
ब्राउज़र के टैब सिस्टम से इंटरैक्ट करने के लिए, chrome.tabs
एपीआई का इस्तेमाल करें. इस एपीआई का इस्तेमाल ब्राउज़र में टैब बनाने, उनमें बदलाव करने, और उन्हें फिर से व्यवस्थित करने के लिए किया जा सकता है.
खास जानकारी
Tabs एपीआई, न सिर्फ़ टैब में हेर-फेर और मैनेज करने की सुविधाएं देता है, बल्कि भाषा के बारे में जानने के लिए, स्क्रीनशॉट लें और टैब की कॉन्टेंट स्क्रिप्ट का बातचीत करें.
अनुमतियां
ज़्यादातर सुविधाओं का इस्तेमाल करने के लिए, किसी अनुमति की ज़रूरत नहीं होती. उदाहरण के लिए: नया टैब बनाना, किसी टैब को फिर से लोड करना, किसी दूसरे यूआरएल पर नेविगेशन करना वगैरह.
Tabs एपीआई का इस्तेमाल करते समय, डेवलपर को तीन अनुमतियों के बारे में पता होना चाहिए.
- "टैब" अनुमति
- यह अनुमति
chrome.tabs
नेमस्पेस को ऐक्सेस नहीं देती. इसके बजाय, चार के मुकाबलेtabs.query()
को कॉल करने की एक्सटेंशन देता हैtabs.Tab
इंस्टेंस पर संवेदनशील प्रॉपर्टी:url
,pendingUrl
,title
, औरfavIconUrl
. - होस्ट की अनुमतियां
- होस्ट की अनुमतियां, किसी एक्सटेंशन को मेल खाने वाले टैब की चार संवेदनशील जानकारी को पढ़ने और उसके बारे में क्वेरी करने की अनुमति देती हैं
tabs.Tab
प्रॉपर्टी. वे इन तरीकों का इस्तेमाल करके, मिलते-जुलते टैब से सीधे इंटरैक्ट भी कर सकते हैंtabs.captureVisibleTab()
के तौर पर,tabs.executeScript()
,tabs.insertCSS()
, औरtabs.removeCSS()
. - "activeTab" अनुमति
activeTab
, इस टैब में मौजूद टैब के लिए, एक्सटेंशन को कुछ समय के लिए होस्ट करने की अनुमति देता है: उपयोगकर्ता के बोले जाने का जवाब.activeTab
, होस्ट की अनुमतियों के उलट कोई चेतावनी ट्रिगर नहीं करता.
मेनिफ़ेस्ट
मेनिफ़ेस्ट में हर अनुमति का एलान करने के तरीके के उदाहरण नीचे दिए गए हैं:
{
"name": "My extension",
...
"permissions": [
"tabs"
],
...
}
{
"name": "My extension",
...
"host_permissions": [
"http://*/*",
"https://*/*"
],
...
}
{
"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.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 एपीआई एक्सटेंशन के ज़्यादा डेमो के लिए, इनमें से किसी एक को एक्सप्लोर करें:
टाइप
MutedInfo
टैब की म्यूट स्थिति और आखिरी बार स्थिति बदलने की वजह.
प्रॉपर्टी
-
extensionId
स्ट्रिंग ज़रूरी नहीं
म्यूट किए गए स्टेटस को बदलने वाले एक्सटेंशन का आईडी. अगर म्यूट किए गए स्टेटस को आखिरी बार बदलने का कारण कोई एक्सटेंशन नहीं था, तो सेट नहीं किया गया.
-
म्यूट किया गया
बूलियन
टैब को म्यूट किया गया है या नहीं (साउंड चलाने से रोका गया है). टैब म्यूट हो सकता है, भले ही वह चलाया न गया हो या अभी आवाज़ न चल रही हो. यह इस बात के बराबर है कि 'म्यूट किया गया' है या नहीं ऑडियो इंडिकेटर दिख रहा है.
-
कारण
MutedInfoReason ज़रूरी नहीं
टैब को म्यूट या अनम्यूट किए जाने की वजह. अगर टैब की म्यूट स्थिति को कभी बदला नहीं गया है, तो सेट नहीं है.
MutedInfoReason
वह इवेंट जिसकी वजह से 'म्यूट किया गया' स्टेटस बदल गया.
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
टैब के लोड होने की स्थिति.
Enum
"अनलोड किया गया"
"लोड हो रहा है"
"पूरा हुआ"
WindowType
विंडो किस तरह की है.
Enum
"सामान्य"
"पॉपअप"
"पैनल"
"ऐप्लिकेशन"
"devtools"
ZoomSettings
यह तय करता है कि किसी टैब में, ज़ूम किए गए बदलावों को कैसे और किस दायरे में हैंडल किया जाता है.
प्रॉपर्टी
-
defaultZoomFactor
नंबर वैकल्पिक
Chrome 43+इसका इस्तेमाल टैब टू कॉल में मौजूदा टैब के डिफ़ॉल्ट ज़ूम लेवल पर वापस जाने के लिए किया जाता है.getZoomSettings पर मौजूद है.
-
मोड
ZoomSettingsMode optional
तय करता है कि ज़ूम से जुड़े बदलाव कैसे मैनेज किए जाते हैं. जैसे, पेज की असल स्केलिंग के लिए कौनसी इकाई ज़िम्मेदार है; डिफ़ॉल्ट रूप से
automatic
हो जाता है. -
दायरा
ZoomSettingsScope ज़रूरी नहीं
तय करता है कि ज़ूम में किए गए बदलाव, पेज के ऑरिजिन के लिए लागू रहेंगे या सिर्फ़ इस टैब में लागू होंगे;
automatic
मोड में होने पर डिफ़ॉल्ट तौर परper-origin
होता है, नहीं तोper-tab
होता है.
ZoomSettingsMode
तय करता है कि ज़ूम से जुड़े बदलाव कैसे मैनेज किए जाते हैं. जैसे, पेज की असल स्केलिंग के लिए कौनसी इकाई ज़िम्मेदार है; डिफ़ॉल्ट रूप से automatic
हो जाता है.
Enum
"अपने-आप"
ज़ूम में होने वाले बदलावों को ब्राउज़र अपने-आप मैनेज करता है.
"मैन्युअल"
ज़ूम इन बदलावों को अपने-आप मैनेज करने की सुविधा को बदलता है. onZoomChange
इवेंट अब भी भेजा जाएगा. इस इवेंट को सुनने और पेज को मैन्युअल तरीके से स्केल करने की ज़िम्मेदारी एक्सटेंशन की है. इस मोड में per-origin
को ज़ूम नहीं किया जा सकता. इसलिए, यह scope
ज़ूम सेटिंग को अनदेखा कर देता है और per-tab
को मान लेता है.
"बंद"
इससे टैब पर ज़ूम इन करने की सभी सुविधाएं बंद हो जाती हैं. ऐसा करने से, टैब डिफ़ॉल्ट ज़ूम लेवल पर सेट हो जाता है और ज़ूम में किए गए सभी बदलाव नज़रअंदाज़ कर दिए जाते हैं.
ZoomSettingsScope
तय करता है कि ज़ूम में किए गए बदलाव, पेज के ऑरिजिन के लिए लागू रहेंगे या सिर्फ़ इस टैब में लागू होंगे; automatic
मोड में होने पर डिफ़ॉल्ट तौर पर per-origin
होता है, नहीं तो per-tab
होता है.
Enum
"हर ऑरिजिन"
ज़ूम किए गए पेज के ऑरिजिन में ज़ूम में बदलाव होते रहते हैं. इसका मतलब है कि उस ऑरिजिन पर जाने वाले दूसरे सभी टैब भी ज़ूम किए जाते हैं. इसके अलावा, ज़ूम में किए गए per-origin
बदलाव, ऑरिजिन के साथ सेव किए जाते हैं. इसका मतलब है कि एक ही ऑरिजिन में दूसरे पेजों पर जाने पर, वे सभी एक ही ज़ूम फ़ैक्टर पर ज़ूम किए जाते हैं. per-origin
स्कोप सिर्फ़ automatic
मोड में उपलब्ध है.
"हर टैब"
ज़ूम में किए गए बदलाव सिर्फ़ इस टैब में लागू होते हैं. अन्य टैब में किए गए ज़ूम बदलावों से, इस टैब की ज़ूमिंग पर कोई असर नहीं पड़ता. साथ ही, नेविगेशन पर ज़ूम करने के per-tab
बदलाव रीसेट होते हैं; किसी टैब पर नेविगेट करने पर, उसके per-origin
ज़ूम फ़ैक्टर के साथ पेज हमेशा लोड होते हैं.
प्रॉपर्टी
MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND
captureVisibleTab
को हर सेकंड ज़्यादा से ज़्यादा कितनी बार कॉल किया जा सकता है. captureVisibleTab
महंगा है और इसे बार-बार कॉल नहीं करना चाहिए.
मान
2
TAB_ID_NONE
यह ऐसा आईडी होता है जिससे पता चलता है कि ब्राउज़र टैब मौजूद नहीं है.
मान
-1
TAB_INDEX_NONE
यह इंडेक्स करने से पता चलता है कि 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
इवेंट चालू हो जाता है.
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.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
रिटर्न
-
वादा<टैब | तय नहीं है>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
executeScript()
chrome.tabs.executeScript(
tabId?: number,
details: InjectDetails,
callback?: function,
)
मेनिफ़ेस्ट V3 में scripting.executeScript
से बदला गया.
किसी पेज में JavaScript कोड इंजेक्ट करता है. ज़्यादा जानकारी के लिए, कॉन्टेंट स्क्रिप्ट दस्तावेज़ का प्रोग्रामैटिक इंजेक्शन सेक्शन देखें.
पैरामीटर
-
tabId
नंबर वैकल्पिक
उस टैब का आईडी, जिसमें स्क्रिप्ट चलाना है; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.
-
विवरण
चलाने के लिए स्क्रिप्ट की जानकारी. कोड या फ़ाइल प्रॉपर्टी में से किसी एक को सेट करना ज़रूरी है, लेकिन दोनों को एक साथ सेट नहीं किया जा सकता.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(result?: any[]) => void
-
नतीजा
कोई भी[] ज़रूरी नहीं
हर इंजेक्ट किए गए फ़्रेम में स्क्रिप्ट का नतीजा.
-
रिटर्न
-
Promise<any[] | तय नहीं है>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
get()
chrome.tabs.get(
tabId: number,
callback?: function,
)
चुने गए टैब के बारे में जानकारी हासिल करता है.
पैरामीटर
-
tabId
संख्या
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(tab: Tab) => void
-
टैब
-
रिटर्न
-
प्रॉमिस<Tab>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
getAllInWindow()
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
दिखाता है.
पैरामीटर
रिटर्न
-
वादा<टैब | तय नहीं है>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
getSelected()
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<number>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
getZoomSettings()
chrome.tabs.getZoomSettings(
tabId?: number,
callback?: function,
)
किसी खास टैब की मौजूदा ज़ूम सेटिंग लागू करता है.
पैरामीटर
-
tabId
नंबर वैकल्पिक
मौजूदा ज़ूम सेटिंग पाने के लिए, टैब का आईडी; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(zoomSettings: ZoomSettings) => void
-
zoomSettings
टैब की मौजूदा ज़ूम सेटिंग.
-
रिटर्न
-
Promise<ZoomSettings>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
goBack()
chrome.tabs.goBack(
tabId?: number,
callback?: function,
)
अगर कोई पेज उपलब्ध है, तो पिछले पेज पर वापस जाएं.
पैरामीटर
-
tabId
नंबर वैकल्पिक
वापस नेविगेट करने के लिए टैब का आईडी; मौजूदा विंडो के चुने गए टैब पर डिफ़ॉल्ट रूप से सेट होता है.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
goForward()
chrome.tabs.goForward(
tabId?: number,
callback?: function,
)
अगर कोई पेज उपलब्ध है, तो अगले पेज पर जाएं.
पैरामीटर
-
tabId
नंबर वैकल्पिक
आगे की ओर नेविगेट करने के लिए टैब का आईडी; मौजूदा विंडो के चुने गए टैब पर डिफ़ॉल्ट रूप से सेट होता है.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
group()
chrome.tabs.group(
options: object,
callback?: function,
)
किसी चुने गए ग्रुप में एक या उससे ज़्यादा टैब जोड़ता है या अगर कोई ग्रुप नहीं चुना गया है, तो दिए गए टैब को नए बनाए गए ग्रुप में जोड़ देता है.
पैरामीटर
-
विकल्प
ऑब्जेक्ट
-
createProperties
ऑब्जेक्ट ज़रूरी नहीं
ग्रुप बनाने के लिए कॉन्फ़िगरेशन. अगर groupId पहले से तय किया गया है, तो इसका इस्तेमाल नहीं किया जा सकता.
-
windowId
नंबर वैकल्पिक
नए ग्रुप की विंडो. डिफ़ॉल्ट तौर पर, यह मौजूदा विंडो पर सेट होती है.
-
-
groupId
नंबर वैकल्पिक
उस ग्रुप का आईडी जिसमें टैब जोड़ना है. अगर इसके बारे में नहीं बताया गया, तो एक नया ग्रुप बना दिया जाएगा.
-
tabIds
नंबर | [नंबर, ...संख्या[]]
किसी खास ग्रुप में जोड़ने के लिए, टैब आईडी या टैब आईडी की सूची.
-
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(groupId: number) => void
-
groupId
संख्या
उस ग्रुप का आईडी जिसमें टैब जोड़े गए थे.
-
रिटर्न
-
Promise<number>
प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
highlight()
chrome.tabs.highlight(
highlightInfo: object,
callback?: function,
)
दिए गए टैब को हाइलाइट करता है और ग्रुप के पहले आइटम पर फ़ोकस करता है. अगर बताया गया टैब अभी चालू है, तो 'कुछ नहीं करता' दिखेगा.
पैरामीटर
-
highlightInfo
ऑब्जेक्ट
-
टैब
नंबर | नंबर[]
हाइलाइट करने के लिए एक या उससे ज़्यादा टैब इंडेक्स.
-
windowId
नंबर वैकल्पिक
वह विंडो जिसमें टैब होते हैं.
-
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(window: Window) => void
-
विंडो
इसमें उस विंडो के बारे में जानकारी होती है जिसके टैब हाइलाइट किए गए थे.
-
रिटर्न
-
Promise<windows.Window>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
insertCSS()
chrome.tabs.insertCSS(
tabId?: number,
details: InjectDetails,
callback?: function,
)
मेनिफ़ेस्ट V3 में scripting.insertCSS
से बदला गया.
सीएसएस को पेज में इंजेक्ट करता है. इस तरीके का इस्तेमाल करके डाली गई स्टाइल को scripting.removeCSS
की मदद से हटाया जा सकता है. ज़्यादा जानकारी के लिए, कॉन्टेंट स्क्रिप्ट दस्तावेज़ का प्रोग्रामैटिक इंजेक्शन सेक्शन देखें.
पैरामीटर
-
tabId
नंबर वैकल्पिक
उस टैब का आईडी, जिसमें सीएसएस डालना है; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.
-
विवरण
शामिल किए जाने वाले सीएसएस टेक्स्ट की जानकारी. कोड या फ़ाइल प्रॉपर्टी में से किसी एक को सेट करना ज़रूरी है, लेकिन दोनों को एक साथ सेट नहीं किया जा सकता.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
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.tabs.removeCSS(
tabId?: number,
details: DeleteInjectionDetails,
callback?: function,
)
मेनिफ़ेस्ट V3 में scripting.removeCSS
से बदला गया.
उस पेज सीएसएस से हटाता है जिसे पहले scripting.insertCSS
पर कॉल करके डाला गया था.
पैरामीटर
-
tabId
नंबर वैकल्पिक
उस टैब का आईडी जिससे सीएसएस हटाना है; डिफ़ॉल्ट रूप से, मौजूदा विंडो के ऐक्टिव टैब पर सेट होता है.
-
विवरण
हटाए जाने वाले सीएसएस टेक्स्ट की जानकारी. कोड या फ़ाइल प्रॉपर्टी में से किसी एक को सेट करना ज़रूरी है, लेकिन दोनों को एक साथ सेट नहीं किया जा सकता.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
sendMessage()
chrome.tabs.sendMessage(
tabId: number,
message: any,
options?: object,
callback?: function,
)
यह तय किए गए टैब में मौजूद कॉन्टेंट स्क्रिप्ट पर एक मैसेज भेजता है. साथ ही, रिस्पॉन्स के वापस भेजे जाने पर, वैकल्पिक कॉलबैक के साथ भी यह काम करता है. मौजूदा एक्सटेंशन के लिए तय किए गए टैब में चल रही हर कॉन्टेंट स्क्रिप्ट में, runtime.onMessage
इवेंट ट्रिगर होता है.
पैरामीटर
-
tabId
संख्या
-
मैसेज
कोई
भेजा जाने वाला मैसेज. यह मैसेज, ऐसा ऑब्जेक्ट होना चाहिए जिसे JSON फ़ॉर्मैट किया जा सके.
-
विकल्प
ऑब्जेक्ट ज़रूरी नहीं
-
कॉलबैक
फ़ंक्शन वैकल्पिक
Chrome 99 या इसके बाद के वर्शनcallback
पैरामीटर ऐसा दिखता है:(response: any) => void
-
जवाब
कोई
मैसेज के हैंडलर से भेजा गया JSON रिस्पॉन्स ऑब्जेक्ट. अगर बताए गए टैब से कनेक्ट करते समय कोई गड़बड़ी होती है, तो कॉलबैक को बिना किसी आर्ग्युमेंट के कॉल किया जाता है और
runtime.lastError
को गड़बड़ी के मैसेज पर सेट किया जाता है.
-
रिटर्न
-
वादा करें<किसी भी>
Chrome 99 या इसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
sendRequest()
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
यह तय करता है कि ज़ूम में किए गए बदलाव कैसे हैंडल किए जाते हैं और किस दायरे में किए जाते हैं.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
ungroup()
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
रिटर्न
-
वादा<टैब | तय नहीं है>
Chrome 88 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
इवेंट
onActivated
chrome.tabs.onActivated.addListener(
callback: function,
)
किसी विंडो में ऐक्टिव टैब के बदलने पर सक्रिय होता है. ध्यान दें, हो सकता है कि इस इवेंट के सक्रिय होने पर टैब का यूआरएल सेट न हो, लेकिन अपडेट किए गए इवेंट सुने जा सकते हैं, ताकि यूआरएल सेट होने पर आपको सूचना दी जा सके.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(activeInfo: object) => void
-
activeInfo
ऑब्जेक्ट
-
tabId
संख्या
उस टैब का आईडी जो चालू हो गया है.
-
windowId
संख्या
उस विंडो का आईडी जिसके अंदर ऐक्टिव टैब बदला गया.
-
-
onActiveChanged
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,
)
यह टैब बनाए जाने पर सक्रिय होता है. ध्यान दें, ऐसा हो सकता है कि इस इवेंट के चालू होते समय, टैब का यूआरएल और टैब ग्रुप की सदस्यता सेट न हो. हालांकि, अपडेट किए गए इवेंट सुने जा सकते हैं, ताकि यूआरएल सेट होने या टैब ग्रुप में टैब जोड़े जाने पर आपको सूचना दी जा सके.
onDetached
chrome.tabs.onDetached.addListener(
callback: function,
)
टैब को विंडो से अलग किए जाने पर सक्रिय होता है; क्योंकि उसे एक विंडो से दूसरी विंडो में ले जाया गया था.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(tabId: number, detachInfo: object) => void
-
tabId
संख्या
-
detachInfo
ऑब्जेक्ट
-
oldPosition
संख्या
-
oldWindowId
संख्या
-
-
onHighlightChanged
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
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
-
-