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

js
let querying = browser.tabs.query(queryInfo)

Parameter

queryInfo

object. Die query()-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 ist true. Wenn auf false gesetzt, kann der Browser den Tab nicht automatisch verwerfen. Es kann allerdings durch tabs.discard verworfen werden.

cookieStoreId Optional

string oder array von string. Verwenden Sie dies, um Tabs zurückzugeben, deren tab.cookieStoreId mit einer der cookieStoreId-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.

hidden Optional

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 oder array von string. 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. Die id des übergeordneten Fensters oder windows.WINDOW_ID_CURRENT für das aktuelle Fenster.

windowType Optional

tabs.WindowType. Der Fenstertyp, in dem sich die Tabs befinden.

Rückgabewert

Ein Promise, das mit einem array von tabs.Tab-Objekten erfüllt wird und Informationen über jeden übereinstimmenden Tab enthält.

Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Alle Tabs abrufen:

js
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:

js
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:

js
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:

js
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);

Beispielerweiterungen

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
query
queryInfo
queryInfo.active
queryInfo.attention
queryInfo.audible
queryInfo.autoDiscardable
queryInfo.cookieStoreId
queryInfo.currentWindow
queryInfo.discarded
queryInfo.highlighted
queryInfo.index
queryInfo.lastFocusedWindow
queryInfo.muted
queryInfo.openerTabId
queryInfo.pinned
queryInfo.status
queryInfo.title
queryInfo.url
queryInfo.windowId
queryInfo.windowType

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
See implementation notes.
Has more compatibility info.

Hinweis: Diese API basiert auf Chromiums chrome.tabs-API. Diese Dokumentation ist abgeleitet von tabs.json im Chromium-Code.