tabs.query() - Mozilla

Syntax

let querying = browser.tabs.query(queryInfo)

Parameter

queryInfo

object. Die Funktion query() erhält die Tabs, deren Eigenschaften mit den hier eingeschlossenen Eigenschaften übereinstimmen.

Für mehr Informationen über diese Eigenschaften siehe die tabs.Tab Dokumentation.

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. Verwenden Sie 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 Berechtigung "cookies" hat. Siehe Arbeiten mit kontextuellen Identitäten für weitere Informationen.
currentWindow Optional: boolean. Ob die Tabs im aktuellen Fenster sind.
discarded Optional: boolean. Ob die Tabs verworfen werden. Ein verworfener Tab ist einer, dessen Inhalt aus dem Speicher entladen wurde, aber immer noch im Tab-Streifen sichtbar ist. Sein Inhalt wird erneut geladen, das nächste Mal, wenn er aktiviert wird.
groupId Optional: integer. Die ID der Tab-Gruppe, in der sich die Tabs befinden, oder -1 (tabGroups.TAB_GROUP_ID_NONE) für nicht gruppierte Tabs. Für mehr Informationen über Tab-Gruppen siehe tabGroups.
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 angeheftet sind.
splitViewId Optional: integer. Die ID der geteilten Ansicht, zu der der Tab gehört. Setzen Sie diese auf tabs.SPLIT_VIEW_ID_NONE um die Tabs abzufragen, die nicht zu einer geteilten Ansicht gehören.
status Optional: tabs.TabStatus. Ob die Tabs das Laden abgeschlossen haben.
title Optional: string. Übereinstimmung von Seitentiteln mit einem Muster. Erfordert die Berechtigung "tabs" oder Host-Berechtigungen, damit der Tab übereinstimmt.
url Optional: string oder array von string. Abgleich von Tabs mit einem oder mehreren Musterabgleichen. Beachten Sie, dass Fragmentbezeichner nicht abgeglichen werden. Erfordert die Berechtigung "tabs" 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, die Informationen über jeden übereinstimmenden Tab enthalten.

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

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

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.tabs-API von Chromium. Diese Dokumentation stammt von tabs.json im Chromium-Code.

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden