tabs.query()
Ruft alle Tabs ab, die die angegebenen Eigenschaften aufweisen, oder alle Tabs, wenn keine Eigenschaften angegeben sind.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
let querying = browser.tabs.query(queryInfo)
Parameter
queryInfo
-
object
. Diequery()
-Funktion erhält die Tabs, deren Eigenschaften mit den hier angegebenen übereinstimmen.Lesen Sie die Dokumentation zu
tabs.Tab
, um mehr über diese Eigenschaften zu erfahren.active
Optional-
boolean
. Ob die Tabs in ihren Fenstern aktiv sind. attention
Optional-
boolean
. Gibt an, ob die Tabs Aufmerksamkeit erregen. audible
Optional-
boolean
. Ob die Tabs hörbar sind. autoDiscardable
Optional-
boolean
. Ob der Tab vom Browser verworfen werden kann. Der Standardwert isttrue
. Wenn auffalse
gesetzt, kann der Browser den Tab nicht automatisch verwerfen. Es kann allerdings durchtabs.discard
verworfen werden. -
string
oderarray
vonstring
. Verwenden Sie dies, um Tabs zurückzugeben, derentab.cookieStoreId
mit einer dercookieStoreId
-Zeichenfolgen übereinstimmt. Diese Option ist nur verfügbar, wenn das Add-on die"cookies"
Berechtigung hat. Siehe Arbeiten mit kontextuellen Identitäten für mehr Informationen. currentWindow
Optional-
boolean
. Ob die Tabs im aktuellen Fenster sind. discarded
Optional-
boolean
. Ob die Tabs verworfen sind. Ein verworfener Tab ist einer, dessen Inhalt aus dem Speicher entladen wurde, aber noch im Tabstreifen sichtbar ist. Sein Inhalt wird beim nächsten Aktivieren neu geladen. -
boolean
. Ob die Tabs versteckt sind. highlighted
Optional-
boolean
. Ob die Tabs hervorgehoben sind. index
Optional-
integer
. Die Position der Tabs innerhalb ihrer Fenster. muted
Optional-
boolean
. Ob die Tabs stummgeschaltet sind. lastFocusedWindow
Optional-
boolean
. Ob die Tabs im zuletzt fokussierten Fenster sind. pinned
Optional-
boolean
. Ob die Tabs angepinnt sind. status
Optional-
tabs.TabStatus
. Ob die Tabs das Laden abgeschlossen haben. title
Optional-
string
. Seiten-Titel mit einem Muster abgleichen. Erfordert die "tabs"-Berechtigung oder Host-Berechtigungen, damit der Tab übereinstimmt. url
Optional-
string
oderarray
vonstring
. Tabs mit einem oder mehreren Matchmustern abgleichen. Beachten Sie, dass auf Fragmentbezeichner nicht abgestimmt wird. Erfordert die "tabs"-Berechtigung oder Host-Berechtigungen, damit der Tab übereinstimmt. windowId
Optional-
integer
. Dieid
des übergeordneten Fensters oderwindows.WINDOW_ID_CURRENT
für das aktuelle Fenster. windowType
Optional-
tabs.WindowType
. Der Fenstertyp, in dem sich die Tabs befinden.
Rückgabewert
Beispiele
Alle Tabs abrufen:
function logTabs(tabs) {
for (const tab of tabs) {
// tab.url requires the `tabs` permission or a matching host permission.
console.log(tab.url);
}
}
function onError(error) {
console.error(`Error: ${error}`);
}
browser.tabs.query({}).then(logTabs, onError);
Alle Tabs im aktuellen Fenster abrufen:
function logTabs(tabs) {
for (const tab of tabs) {
// tab.url requires the `tabs` permission or a matching host permission.
console.log(tab.url);
}
}
function onError(error) {
console.error(`Error: ${error}`);
}
browser.tabs.query({ currentWindow: true }).then(logTabs, onError);
Den aktiven Tab im aktuellen Fenster abrufen:
function logTabs(tabs) {
// tabs[0].url requires the `tabs` permission or a matching host permission.
console.log(tabs[0].url);
}
function onError(error) {
console.error(`Error: ${error}`);
}
browser.tabs
.query({ currentWindow: true, active: true })
.then(logTabs, onError);
Tabs für alle HTTP- und HTTPS-URLs unter "mozilla.org"
oder einem seiner Subdomains abrufen:
function logTabs(tabs) {
for (const tab of tabs) {
// tab.url requires the `tabs` permission or a matching host permission.
console.log(tab.url);
}
}
function onError(error) {
console.error(`Error: ${error}`);
}
browser.tabs.query({ url: "*://*.mozilla.org/*" }).then(logTabs, onError);
Beispiel-Erweiterungen
Browser-Kompatibilität
BCD tables only load in the browser
Hinweis: Diese API basiert auf Chromiums chrome.tabs
-API. Diese Dokumentation ist abgeleitet von tabs.json
im Chromium-Code.