tabs.query()

Ruft alle Tabs ab, die die angegebenen Eigenschaften aufweisen, oder alle Tabs, wenn keine Eigenschaften festgelegt sind.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

let querying = browser.tabs.query(queryInfo)

Parameter

queryInfo

object. Die query()-Funktion ruft die Tabs ab, deren Eigenschaften mit den hier enthaltenen Eigenschaften übereinstimmen.

Siehe 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. Der Tab kann jedoch durch tabs.discard verworfen werden.
cookieStoreId Optional: string oder array von string. Verwendet dies, um Tabs zurückzugeben, deren tab.cookieStoreId mit einem der cookieStoreId-Strings ü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 entfernt wurde, aber immer noch in der Tab-Leiste 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. Übereinstimmung von Seitentiteln mit einem Muster. Erfordert die "tabs"-Berechtigung oder Host-Berechtigungen für den Tab zur Übereinstimmung.
url Optional: string oder array von string. Übereinstimmung von Tabs mit einem oder mehreren Übereinstimmungsmustern. Beachten Sie, dass Fragment-Identifikatoren nicht übereinstimmen. Erfordert die "tabs"-Berechtigung oder Host-Berechtigungen für den Tab zur Übereinstimmung.
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, das Informationen über jeden übereinstimmenden Tab enthält.

Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung zurückgewiesen.

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

Beispielerweiterungen

Browser-Kompatibilität

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