chrome.tabs

Beschreibung

Mit der chrome.tabs API können Sie mit dem Tabsystem des Browsers interagieren. Mit dieser API können Sie Tabs im Browser erstellen, ändern und neu anordnen.

Übersicht

Die Tabs API bietet nicht nur Funktionen zum Bearbeiten und Verwalten von Tabs, sondern kann auch die Sprache des Tabs erkennen, einen Screenshot erstellen und mit den Inhaltsskripts eines Tabs kommunizieren.

Berechtigungen

Für die meisten Funktionen sind keine Berechtigungen erforderlich. Beispiele: Einen neuen Tab erstellen, einen Tab neu laden, zu einer anderen URL wechseln usw.

Entwickler sollten sich mit drei Berechtigungen vertraut machen, wenn sie mit der Tabs API arbeiten.

Die Berechtigung „Tabs“
Diese Berechtigung gewährt keinen Zugriff auf den Namespace chrome.tabs. Stattdessen wird einer Erweiterung die Möglichkeit eingeräumt, tabs.query() für vier vertrauliche Attribute von tabs.Tab-Instanzen aufzurufen: url, pendingUrl, title und favIconUrl.
Hostberechtigungen
Mit
Hostberechtigungen kann eine Erweiterung die vier sensiblen tabs.Tab-Properties eines übereinstimmenden Tabs lesen und abfragen. Sie können auch direkt mit den entsprechenden Tabs interagieren, indem sie Methoden wie tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() und tabs.removeCSS() verwenden.
Die Berechtigung „activeTab“
activeTab gewährt einer Erweiterung als Reaktion auf einen Nutzeraufruf eine temporäre Hostberechtigung für den aktuellen Tab. Im Gegensatz zu Hostberechtigungen werden bei activeTab keine Warnungen ausgelöst.

Manifest

Im Folgenden finden Sie Beispiele dafür, wie Sie die einzelnen Berechtigungen im Manifest deklarieren:

  {
    "name": "My extension",
    ...
    "permissions": [
      "tabs"
    ],
    ...
  }


  {
    "name": "My extension",
    ...
    "host_permissions": [
      "http://*/*",
      "https://*/*"
    ],
    ...
  }


  {
    "name": "My extension",
    ...
    "permissions": [
      "activeTab"
    ],
    ...
  }

Anwendungsfälle

In den folgenden Abschnitten werden einige gängige Anwendungsfälle beschrieben.

Erweiterungsseite in einem neuen Tab öffnen

Ein gängiges Muster für Erweiterungen ist, dass beim Installieren der Erweiterung eine Onboarding-Seite in einem neuen Tab geöffnet wird. Das folgende Beispiel zeigt, wie das geht.

background.js:

chrome.runtime.onInstalled.addListener(({reason}) => {
  if (reason === 'install') {
    chrome.tabs.create({
      url: "onboarding.html"
    });
  }
});

Aktuellen Tab abrufen

In diesem Beispiel wird gezeigt, wie der Service Worker einer Erweiterung den aktiven Tab aus dem aktuell fokussierten Fenster (oder dem zuletzt fokussierten Fenster, wenn kein Chrome-Fenster fokussiert ist) abrufen kann. Das ist in der Regel der aktuelle Tab des Nutzers.

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

Den angegebenen Tab stummschalten

In diesem Beispiel wird gezeigt, wie eine Erweiterung den Stumm-Status für einen bestimmten Tab umschalten kann.

  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" }`);
    });
  }

Aktuellen Tab bei Klick an die erste Position verschieben

In diesem Beispiel wird gezeigt, wie ein Tab verschoben wird, während ein Drag-Vorgang läuft oder nicht. In diesem Beispiel wird chrome.tabs.move verwendet. Sie können dasselbe Warte-Muster aber auch für andere Aufrufe verwenden, mit denen Tabs geändert werden, während ein Drag-Vorgang läuft.

  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.");
      }
    });
  }

Nachricht an das Content-Script eines ausgewählten Tabs übergeben

In diesem Beispiel wird gezeigt, wie der Service Worker einer Erweiterung mithilfe von tabs.sendMessage() mit Inhaltsscripts auf bestimmten Browser-Tabs kommunizieren kann.

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.
}

Beispiele für Erweiterungen

Weitere Demos für Tabs API-Erweiterungen finden Sie hier:

Typen

MutedInfo

Chrome 46 und höher

Der Stummgeschaltet-Status des Tabs und der Grund für die letzte Statusänderung.

Attribute

  • extensionId

    String optional

    Die ID der Erweiterung, die den Stummschaltungsstatus geändert hat. Wird nicht festgelegt, wenn eine Erweiterung nicht der Grund für die letzte Änderung des stummgeschalteten Status war.

  • stummgeschaltet

    boolean

    Gibt an, ob der Tab stummgeschaltet ist (kein Ton wiedergegeben wird). Der Tab ist möglicherweise stummgeschaltet, auch wenn er noch keinen Ton wiedergegeben hat oder gerade keinen Ton wiedergibt. Entspricht der Anzeige des Audioindikators „Stumm“.

  • reason

    MutedInfoReason optional

    Der Grund, warum der Tab stummgeschaltet oder die Stummschaltung aufgehoben wurde. Nicht festgelegt, wenn der Stummschaltungsstatus des Tabs noch nie geändert wurde.

MutedInfoReason

Chrome 46 und höher

Ein Ereignis, das eine Änderung des Stummschaltungsstatus verursacht hat.

Enum

user
Der Stumm-Status wurde durch eine Nutzereingabe festgelegt.

„capture“
Die Tab-Aufnahme wurde gestartet, wodurch eine Änderung des Stummschaltungsstatus erzwungen wurde.

„extension“
Eine Erweiterung, die durch das Feld „extensionId“ identifiziert wird, hat den Stummgeschaltet-Status festgelegt.

Tab

Attribute

  • Aktiv

    boolean

    Gibt an, ob der Tab im Fenster aktiv ist. Das bedeutet nicht unbedingt, dass das Fenster fokussiert ist.

  • audible

    boolean optional

    Chrome 45 und höher

    Gibt an, ob auf dem Tab in den letzten Sekunden Ton wiedergegeben wurde. Das ist möglicherweise nicht zu hören, wenn der Tab stummgeschaltet ist. Entspricht der Anzeige des Indikators „Lautsprecher-Audio“.

  • autoDiscardable

    boolean

    Chrome 54 und höher

    Gibt an, ob der Tab vom Browser automatisch verworfen werden kann, wenn nur noch wenige Ressourcen verfügbar sind.

  • verworfen

    boolean

    Chrome 54 und höher

    Gibt an, ob der Tab verworfen wird. Ein verworfener Tab ist ein Tab, dessen Inhalt aus dem Arbeitsspeicher entladen wurde, der aber weiterhin in der Tableiste sichtbar ist. Die Inhalte werden beim nächsten Aktivieren neu geladen.

  • favIconUrl

    String optional

    Die URL des Favicons des Tabs. Diese Eigenschaft ist nur vorhanden, wenn die Erweiterung die Berechtigung "tabs" oder Hostberechtigungen für die Seite hat. Es kann auch ein leerer String sein, wenn der Tab geladen wird.

  • eingefroren

    boolean

    Chrome 132 und höher

    Gibt an, ob der Tab eingefroren ist. Auf einem fixierten Tab können keine Aufgaben ausgeführt werden, z. B. Event-Handler oder Timer. Er ist in der Tableiste sichtbar und sein Inhalt wird in den Arbeitsspeicher geladen. Bei der Aktivierung wird die Sperre aufgehoben.

  • groupId

    Zahl

    Chrome 88 und höher

    Die ID der Gruppe, zu der der Tab gehört.

  • Höhe

    number optional

    Die Höhe des Tabs in Pixeln.

  • hervorgehoben

    boolean

    Gibt an, ob der Tab hervorgehoben ist.

  • id

    number optional

    Die ID des Tabs. Tab-IDs sind innerhalb einer Browsersitzung eindeutig. Unter Umständen wird einem Tab keine ID zugewiesen, z. B. wenn Sie mit der sessions API fremde Tabs abfragen. In diesem Fall ist möglicherweise eine Sitzungs-ID vorhanden. Die Tab-ID kann auch auf chrome.tabs.TAB_ID_NONE für Apps und DevTools-Fenster festgelegt werden.

  • Inkognito

    boolean

    Gibt an, ob sich der Tab in einem Inkognitofenster befindet.

  • Index

    Zahl

    Der nullbasierte Index des Tabs im Fenster.

  • lastAccessed

    Zahl

    Chrome 121 und höher

    Die letzte Aktivierung des Tabs in seinem Fenster als Anzahl der Millisekunden seit der Epoche.

  • mutedInfo

    MutedInfo optional

    Chrome 46 und höher

    Der Stummgeschaltet-Status des Tabs und der Grund für die letzte Statusänderung.

  • openerTabId

    number optional

    Die ID des Tabs, der diesen Tab geöffnet hat (falls vorhanden). Dieses Attribut ist nur vorhanden, wenn der Tab, auf dem die Seite geöffnet wurde, noch vorhanden ist.

  • pendingUrl

    String optional

    Chrome 79 und höher

    Die URL, zu der der Tab navigiert, bevor er bestätigt wurde. Diese Eigenschaft ist nur vorhanden, wenn die Erweiterung die Berechtigung "tabs" oder Hostberechtigungen für die Seite hat und eine Navigation aussteht.

  • Angepinnt

    boolean

    Gibt an, ob der Tab angepinnt ist.

  • ausgewählt

    boolean

    Eingestellt

    Verwenden Sie tabs.Tab.highlighted.

    Gibt an, ob der Tab ausgewählt ist.

  • sessionId

    String optional

    Die Sitzungs-ID, mit der ein Tab, der über die sessions API abgerufen wurde, eindeutig identifiziert wird.

  • Status

    TabStatus optional

    Der Ladestatus des Tabs.

  • Titel

    String optional

    Der Titel des Tabs. Diese Eigenschaft ist nur vorhanden, wenn die Erweiterung die Berechtigung "tabs" oder Hostberechtigungen für die Seite hat.

  • URL

    String optional

    Die zuletzt bestätigte URL des Hauptframes des Tabs. Diese Eigenschaft ist nur vorhanden, wenn die Erweiterung die Berechtigung "tabs" oder Hostberechtigungen für die Seite hat. Kann ein leerer String sein, wenn der Tab noch nicht übernommen wurde. Weitere Informationen finden Sie unter Tab.pendingUrl.

  • Breite

    number optional

    Die Breite des Tabs in Pixeln.

  • windowId

    Zahl

    Die ID des Fensters, das den Tab enthält.

TabStatus

Chrome 44 und höher

Der Ladestatus des Tabs.

Enum

"unloaded"

"loading"

„complete“

WindowType

Chrome 44 und höher

Der Typ des Fensters.

Enum

"normal"

"popup"

„panel“

"app"

"devtools"

ZoomSettings

Definiert, wie Zoomänderungen in einem Tab behandelt werden und in welchem Umfang.

Attribute

  • defaultZoomFactor

    number optional

    Chrome 43 und höher

    Wird verwendet, um die Standardzoomstufe für den aktuellen Tab in Aufrufen von „tabs.getZoomSettings“ zurückzugeben.

  • Modus

    ZoomSettingsMode optional

    Definiert, wie Zoomänderungen behandelt werden, d. h., welche Einheit für die tatsächliche Skalierung der Seite verantwortlich ist. Der Standardwert ist automatic.

  • Bereich

    ZoomSettingsScope optional

    Gibt an, ob Zoomänderungen für den Ursprung der Seite beibehalten werden oder nur auf diesem Tab wirksam sind. Der Standardwert ist per-origin im automatic-Modus und per-tab in allen anderen Fällen.

ZoomSettingsMode

Chrome 44 und höher

Definiert, wie Zoomänderungen behandelt werden, d. h., welche Einheit für die tatsächliche Skalierung der Seite verantwortlich ist. Der Standardwert ist automatic.

Enum

„automatic“
Zoomänderungen werden automatisch vom Browser vorgenommen.

„manual“
Überschreibt die automatische Verarbeitung von Zoomänderungen. Das onZoomChange-Ereignis wird weiterhin gesendet. Es liegt in der Verantwortung der Erweiterung, auf dieses Ereignis zu warten und die Seite manuell zu skalieren. In diesem Modus wird kein per-origin-Zoomen unterstützt. Die Zoom-Einstellung scope wird daher ignoriert und es wird per-tab angenommen.

disabled
Deaktiviert das Zoomen auf dem Tab. Der Tab wird auf die Standardzoomstufe zurückgesetzt und alle versuchten Zoomänderungen werden ignoriert.

ZoomSettingsScope

Chrome 44 und höher

Gibt an, ob Zoomänderungen für den Ursprung der Seite beibehalten werden oder nur auf diesem Tab wirksam sind. Der Standardwert ist per-origin im automatic-Modus und per-tab in allen anderen Fällen.

Enum

„per-origin“
Zoomänderungen bleiben in der Quelle der gezoomten Seite erhalten. Das bedeutet, dass auch alle anderen Tabs, die zu derselben Quelle navigieren, gezoomt werden. Außerdem werden per-origin-Zoomänderungen mit dem Ursprung gespeichert. Wenn Sie also zu anderen Seiten im selben Ursprung wechseln, wird für alle derselbe Zoomfaktor verwendet. Der Bereich per-origin ist nur im Modus automatic verfügbar.

„Pro Tab“
Zoomänderungen werden nur auf diesem Tab übernommen. Zoomänderungen auf anderen Tabs wirken sich nicht auf das Zoomen dieses Tabs aus. Außerdem werden per-tab-Zoomänderungen bei der Navigation zurückgesetzt. Wenn Sie einen Tab aufrufen, werden Seiten immer mit ihren per-origin-Zoomfaktoren geladen.

Attribute

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 und höher

Die maximale Anzahl von Aufrufen von captureVisibleTab pro Sekunde. captureVisibleTab ist teuer und sollte nicht zu oft aufgerufen werden.

Wert

2

TAB_ID_NONE

Chrome 46 und höher

Eine ID, die das Fehlen eines Browsertabs darstellt.

Wert

-1

TAB_INDEX_NONE

Chrome 123 und höher

Ein Index, der das Fehlen eines Tabindex in einem „tab_strip“ darstellt.

Wert

-1

Methoden

captureVisibleTab()

Promise 
chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
): Promise<string>

Erfasst den sichtbaren Bereich des aktuell aktiven Tabs im angegebenen Fenster. Damit diese Methode aufgerufen werden kann, muss die Erweiterung entweder die Berechtigung <all_urls> oder die Berechtigung activeTab haben. Zusätzlich zu den Websites, auf die Erweiterungen normalerweise zugreifen können, ermöglicht diese Methode Erweiterungen, sensible Websites zu erfassen, die ansonsten eingeschränkt sind, einschließlich Seiten des Schemas „chrome:“, Seiten anderer Erweiterungen und data:-URLs. Diese sensiblen Websites können nur mit der Berechtigung „activeTab“ erfasst werden. Datei-URLs dürfen nur erfasst werden, wenn der Erweiterung der Dateizugriff gewährt wurde.

Parameter

  • windowId

    number optional

    Das Zielfenster. Die Standardeinstellung ist der aktuelle Zeitraum.

  • Optionen

    ImageDetails optional

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (dataUrl: string) => void

    • dataUrl

      String

      Eine Daten-URL, die ein Bild des sichtbaren Bereichs des erfassten Tabs codiert. Kann der „src“-Property eines HTML-img-Elements zur Anzeige zugewiesen werden.

Ausgabe

  • Promise<string>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

connect()

chrome.tabs.connect(
  tabId: number,
  connectInfo?: object,
): runtime.Port

Stellt eine Verbindung zum Inhaltsskript bzw. zu den Inhaltsskripts auf dem angegebenen Tab her. Das Ereignis runtime.onConnect wird in jedem Inhaltsscript ausgelöst, das auf dem angegebenen Tab für die aktuelle Erweiterung ausgeführt wird. Weitere Informationen finden Sie unter Content-Script-Messaging.

Parameter

  • tabId

    Zahl

  • connectInfo

    object optional

    • documentId

      String optional

      Chrome 106 und höher

      Öffnen Sie einen Port für ein bestimmtes Dokument, das durch documentId identifiziert wird, anstatt für alle Frames auf dem Tab.

    • frameId

      number optional

      Öffnet einen Port für einen bestimmten Frame, der durch frameId identifiziert wird, anstatt für alle Frames auf dem Tab.

    • name

      String optional

      Wird an „onConnect“ für Inhaltsscripts übergeben, die auf das Verbindungsereignis warten.

Ausgabe

  • Ein Port, der für die Kommunikation mit den Inhaltsskripts verwendet werden kann, die auf dem angegebenen Tab ausgeführt werden. Das runtime.Port-Ereignis des Ports wird ausgelöst, wenn der Tab geschlossen wird oder nicht vorhanden ist.

create()

Promise 
chrome.tabs.create(
  createProperties: object,
  callback?: function,
): Promise<Tab>

Erstellt einen neuen Tab.

Parameter

  • createProperties

    Objekt

    • Aktiv

      boolean optional

      Gibt an, ob der Tab zum aktiven Tab im Fenster werden soll. Hat keinen Einfluss darauf, ob das Fenster den Fokus hat (siehe windows.update). Der Standardwert ist true.

    • Index

      number optional

      Die Position, die der Tab im Fenster einnehmen soll. Der angegebene Wert wird auf einen Wert zwischen null und der Anzahl der Tabs im Fenster begrenzt.

    • openerTabId

      number optional

      Die ID des Tabs, über den dieser Tab geöffnet wurde. Wenn angegeben, muss sich der Tab, der den neuen Tab geöffnet hat, im selben Fenster wie der neu erstellte Tab befinden.

    • Angepinnt

      boolean optional

      Gibt an, ob der Tab angepinnt werden soll. Die Standardeinstellung ist false.

    • ausgewählt

      boolean optional

      Eingestellt

      Verwenden Sie stattdessen active.

      Gibt an, ob der Tab der ausgewählte Tab im Fenster werden soll. Die Standardeinstellung ist true.

    • URL

      String optional

      Die URL, zu der der Tab anfangs navigieren soll. Vollständig qualifizierte URLs müssen ein Schema enthalten (z.B. „http://www.google.com“ und nicht „www.google.com“). Relative URLs beziehen sich auf die aktuelle Seite in der Erweiterung. Standardmäßig wird die Seite „Neuer Tab“ verwendet.

    • windowId

      number optional

      Das Fenster, in dem der neue Tab erstellt werden soll. Die Standardeinstellung ist der aktuelle Zeitraum.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab: Tab) => void

    • Tabulatortaste

      Tab

      Das erstellte Tab.

Ausgabe

  • Promise<Tab>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

detectLanguage()

Promise 
chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
): Promise<string>

Erkennt die primäre Sprache des Inhalts auf einem Tab.

Parameter

  • tabId

    number optional

    Standardmäßig wird der aktive Tab des aktuellen Fensters verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (language: string) => void

    • Sprache

      String

      Ein ISO-Sprachcode wie en oder fr. Eine vollständige Liste der von dieser Methode unterstützten Sprachen finden Sie unter kLanguageInfoTable. Die zweite bis vierte Spalte werden geprüft und der erste Nicht-NULL-Wert wird zurückgegeben, mit Ausnahme von vereinfachtem Chinesisch, für das zh-CN zurückgegeben wird. Für eine unbekannte/undefinierte Sprache wird und zurückgegeben.

Ausgabe

  • Promise<string>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

discard()

Promise Chrome 54 oder höher 
chrome.tabs.discard(
  tabId?: number,
  callback?: function,
): Promise<Tab | undefined>

Entfernt einen Tab aus dem Arbeitsspeicher. Verworfene Tabs sind weiterhin in der Tableiste sichtbar und werden neu geladen, wenn sie aktiviert werden.

Parameter

  • tabId

    number optional

    Die ID des zu schließenden Tabs. Falls angegeben, wird der Tab verworfen, sofern er nicht aktiv oder bereits verworfen ist. Wenn nichts angegeben ist, wird der unwichtigste Tab geschlossen. Dies kann fehlschlagen, wenn keine Tabs vorhanden sind, die verworfen werden können.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab?: Tab) => void

    • Tabulatortaste

      Tab optional

      Der verworfene Tab, falls er erfolgreich verworfen wurde. Andernfalls „undefined“.

Ausgabe

  • Promise<Tab | undefined>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

duplicate()

Promise 
chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
): Promise<Tab | undefined>

Dupliziert einen Tab.

Parameter

  • tabId

    Zahl

    Die ID des zu duplizierenden Tabellenblatts.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab?: Tab) => void

    • Tabulatortaste

      Tab optional

      Details zum duplizierten Tab. Die Properties url, pendingUrl, title und favIconUrl sind nur im tabs.Tab-Objekt enthalten, wenn die Erweiterung die Berechtigung "tabs" oder Hostberechtigungen für die Seite hat.

Ausgabe

  • Promise<Tab | undefined>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

executeScript()

Promise &leq; MV2 Seit Chrome 91 eingestellt
chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<any[] | undefined>

In Manifest V3 durch scripting.executeScript ersetzt.

Fügt JavaScript-Code in eine Seite ein. Weitere Informationen finden Sie im Abschnitt Programmatisches Einfügen der Dokumentation zu Content-Scripts.

Parameter

  • tabId

    number optional

    Die ID des Tabs, auf dem das Skript ausgeführt werden soll. Standardmäßig wird der aktive Tab des aktuellen Fensters verwendet.

  • Details

    InjectDetails

    Details zum auszuführenden Skript. Entweder der Code oder die Dateieigenschaft muss festgelegt werden, aber nicht beides gleichzeitig.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result?: any[]) => void

    • Ergebnis

      any[] optional

      Das Ergebnis des Skripts in jedem eingefügten Frame.

Ausgabe

  • Promise<any[] | undefined>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

get()

Promise 
chrome.tabs.get(
  tabId: number,
  callback?: function,
): Promise<Tab>

Ruft Details zum angegebenen Tab ab.

Parameter

  • tabId

    Zahl

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab: Tab) => void

    • Tabulatortaste

      Tab

Ausgabe

  • Promise<Tab>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getAllInWindow()

Promise &leq; MV2 Eingestellt
chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
): Promise<Tab[]>

Verwenden Sie tabs.query {windowId: windowId}.

Ruft Details zu allen Tabs im angegebenen Fenster ab.

Parameter

  • windowId

    number optional

    Die Standardeinstellung ist der aktuelle Zeitraum.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tabs: Tab[]) => void

Ausgabe

  • Promise<Tab[]>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getCurrent()

Promise 
chrome.tabs.getCurrent(
  callback?: function,
): Promise<Tab | undefined>

Ruft den Tab ab, von dem dieser Scriptaufruf erfolgt. Gibt undefined zurück, wenn die Funktion aus einem Kontext ohne Tab aufgerufen wird (z. B. eine Hintergrundseite oder ein Pop-up-Fenster).

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab?: Tab) => void

    • Tabulatortaste

      Tab optional

Ausgabe

  • Promise<Tab | undefined>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getSelected()

Promise &leq; MV2 Eingestellt
chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
): Promise<Tab>

Verwenden Sie tabs.query {active: true}.

Ruft den Tab ab, der im angegebenen Fenster ausgewählt ist.

Parameter

  • windowId

    number optional

    Die Standardeinstellung ist der aktuelle Zeitraum.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab: Tab) => void

    • Tabulatortaste

      Tab

Ausgabe

  • Promise<Tab>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getZoom()

Promise 
chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
): Promise<number>

Ruft den aktuellen Zoomfaktor eines angegebenen Tabs ab.

Parameter

  • tabId

    number optional

    Die ID des Tabs, für den der aktuelle Zoomfaktor abgerufen werden soll. Standardmäßig wird der aktive Tab des aktuellen Fensters verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (zoomFactor: number) => void

    • zoomFactor

      Zahl

      Der aktuelle Zoomfaktor des Tabs.

Ausgabe

  • Promise<number>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getZoomSettings()

Promise 
chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
): Promise<ZoomSettings>

Ruft die aktuellen Zoomeinstellungen eines angegebenen Tabs ab.

Parameter

  • tabId

    number optional

    Die ID des Tabs, aus dem die aktuellen Zoomeinstellungen abgerufen werden sollen. Standardmäßig wird der aktive Tab des aktuellen Fensters verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (zoomSettings: ZoomSettings) => void

    • zoomSettings

      ZoomSettings

      Die aktuellen Zoomeinstellungen des Tabs.

Ausgabe

  • Promise<ZoomSettings>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

goBack()

Promise Chrome 72 und höher 
chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
): Promise<void>

Gehen Sie zur vorherigen Seite zurück, falls eine verfügbar ist.

Parameter

  • tabId

    number optional

    Die ID des Tabs, zu dem zurückgekehrt werden soll. Standardmäßig wird der ausgewählte Tab des aktuellen Fensters verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

goForward()

Promise Chrome 72 und höher 
chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
): Promise<void>

Gehe zur nächsten Seite, falls eine verfügbar ist.

Parameter

  • tabId

    number optional

    Die ID des Tabs, zu dem weitergeleitet werden soll. Standardmäßig wird der ausgewählte Tab des aktuellen Fensters verwendet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

group()

Promise Chrome 88 oder höher 
chrome.tabs.group(
  options: object,
  callback?: function,
): Promise<number>

Fügt einer angegebenen Gruppe einen oder mehrere Tabs hinzu. Wenn keine Gruppe angegeben ist, werden die angegebenen Tabs einer neu erstellten Gruppe hinzugefügt.

Parameter

  • Optionen

    Objekt

    • createProperties

      object optional

      Konfigurationen zum Erstellen einer Gruppe. Kann nicht verwendet werden, wenn „groupId“ bereits angegeben ist.

      • windowId

        number optional

        Das Fenster der neuen Gruppe. Standardmäßig wird das aktuelle Fenster verwendet.

    • groupId

      number optional

      Die ID der Gruppe, der die Tabs hinzugefügt werden sollen. Wenn keine Gruppe angegeben ist, wird eine neue Gruppe erstellt.

    • tabIds

      number | [number, ...number[]]

      Die Tab-ID oder Liste der Tab-IDs, die der angegebenen Gruppe hinzugefügt werden sollen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (groupId: number) => void

    • groupId

      Zahl

      Die ID der Gruppe, der die Tabs hinzugefügt wurden.

Ausgabe

  • Promise<number>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

highlight()

Promise 
chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
): Promise<windows.Window>

Hebt die angegebenen Tabs hervor und konzentriert sich auf den ersten der Gruppe. Scheint nichts zu bewirken, wenn der angegebene Tab derzeit aktiv ist.

Parameter

  • highlightInfo

    Objekt

    • Tabs

      number | number[]

      Ein oder mehrere Tab-Indizes, die hervorgehoben werden sollen.

    • windowId

      number optional

      Das Fenster, das die Tabs enthält.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (window: Window) => void

    • Fenster

      Fenster

      Enthält Details zum Fenster, dessen Tabs hervorgehoben wurden.

Ausgabe

  • Promise<windows.Window>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

insertCSS()

Promise &leq; MV2 Seit Chrome 91 eingestellt
chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<void>

In Manifest V3 durch scripting.insertCSS ersetzt.

CSS in eine Seite einfügen. Mit dieser Methode eingefügte Stile können mit scripting.removeCSS entfernt werden. Weitere Informationen finden Sie im Abschnitt Programmatisches Einfügen der Dokumentation zu Content-Scripts.

Parameter

  • tabId

    number optional

    Die ID des Tabs, in den das CSS eingefügt werden soll. Standardmäßig wird der aktive Tab des aktuellen Fensters verwendet.

  • Details

    InjectDetails

    Details zum einzufügenden CSS-Text. Entweder der Code oder die Dateieigenschaft muss festgelegt werden, aber nicht beides gleichzeitig.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

move()

Promise 
chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
  callback?: function,
): Promise<Tab | Tab[]>

Verschiebt einen oder mehrere Tabs an eine neue Position im Fenster oder in ein neues Fenster. Tabs können nur in und aus normalen Fenstern (window.type === „normal“) verschoben werden.

Parameter

  • tabIds

    number | number[]

    Die Tab-ID oder Liste der Tab-IDs, die verschoben werden sollen.

  • moveProperties

    Objekt

    • Index

      Zahl

      Die Position, an die das Fenster verschoben werden soll. Mit -1 können Sie den Tab am Ende des Fensters platzieren.

    • windowId

      number optional

      Standardmäßig wird das Fenster verwendet, in dem sich der Tab gerade befindet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tabs: Tab | Tab[]) => void

    • Tabs

      Tab | Tab[]

      Details zu den verschobenen Tabs

Ausgabe

  • Promise<Tab | Tab[]>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

query()

Promise 
chrome.tabs.query(
  queryInfo: object,
  callback?: function,
): Promise<Tab[]>

Ruft alle Tabs mit den angegebenen Eigenschaften ab oder alle Tabs, wenn keine Eigenschaften angegeben sind.

Parameter

  • queryInfo

    Objekt

    • Aktiv

      boolean optional

      Gibt an, ob die Tabs in ihren Fenstern aktiv sind.

    • audible

      boolean optional

      Chrome 45 und höher

      Gibt an, ob die Tabs hörbar sind.

    • autoDiscardable

      boolean optional

      Chrome 54 und höher

      Gibt an, ob die Tabs vom Browser automatisch verworfen werden können, wenn nur noch wenige Ressourcen verfügbar sind.

    • currentWindow

      boolean optional

      Gibt an, ob sich die Tabs im aktuellen Fenster befinden.

    • verworfen

      boolean optional

      Chrome 54 und höher

      Gibt an, ob die Tabs verworfen werden. Ein verworfener Tab ist ein Tab, dessen Inhalt aus dem Arbeitsspeicher entladen wurde, der aber weiterhin in der Tableiste sichtbar ist. Die Inhalte werden beim nächsten Aktivieren neu geladen.

    • eingefroren

      boolean optional

      Chrome 132 und höher

      Gibt an, ob die Tabs eingefroren sind. Auf einem fixierten Tab können keine Aufgaben ausgeführt werden, z. B. Event-Handler oder Timer. Er ist in der Tableiste sichtbar und sein Inhalt wird in den Arbeitsspeicher geladen. Bei der Aktivierung wird die Sperre aufgehoben.

    • groupId

      number optional

      Chrome 88 und höher

      Die ID der Gruppe, in der sich die Tabs befinden, oder tabGroups.TAB_GROUP_ID_NONE für nicht gruppierte Tabs.

    • hervorgehoben

      boolean optional

      Gibt an, ob die Tabs hervorgehoben werden.

    • Index

      number optional

      Die Position der Tabs in den Fenstern.

    • lastFocusedWindow

      boolean optional

      Gibt an, ob sich die Tabs im zuletzt fokussierten Fenster befinden.

    • stummgeschaltet

      boolean optional

      Chrome 45 und höher

      Gibt an, ob die Tabs stummgeschaltet sind.

    • Angepinnt

      boolean optional

      Gibt an, ob die Tabs angepinnt sind.

    • splitViewId

      number optional

      Chrome 140+

      Die ID der geteilten Ansicht, in der sich die Tabs befinden, oder tabs.SPLIT_VIEW_ID_NONE für Tabs, die sich nicht in einer geteilten Ansicht befinden.

    • Status

      TabStatus optional

      Der Ladestatus des Tabs.

    • Titel

      String optional

      Seitentitel mit einem Muster abgleichen. Diese Property wird ignoriert, wenn die Erweiterung nicht die Berechtigung "tabs" oder Hostberechtigungen für die Seite hat.

    • URL

      String | String[] optional

      Tabs mit einem oder mehreren URL-Mustern abgleichen. Fragmentbezeichner werden nicht berücksichtigt. Diese Property wird ignoriert, wenn die Erweiterung nicht die Berechtigung "tabs" oder Hostberechtigungen für die Seite hat.

    • windowId

      number optional

      Die ID des übergeordneten Fensters oder windows.WINDOW_ID_CURRENT für das aktuelle Fenster.

    • windowType

      WindowType optional

      Der Fenstertyp, in dem sich die Tabs befinden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Tab[]) => void

    • Ergebnis

      Tab[]

Ausgabe

  • Promise<Tab[]>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

reload()

Promise 
chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
): Promise<void>

Tab neu laden

Parameter

  • tabId

    number optional

    Die ID des Tabs, der neu geladen werden soll. Standardmäßig wird der ausgewählte Tab des aktuellen Fensters verwendet.

  • reloadProperties

    object optional

    • bypassCache

      boolean optional

      Gibt an, ob das lokale Caching umgangen werden soll. Die Standardeinstellung ist false.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

remove()

Promise 
chrome.tabs.remove(
  tabIds: number | number[],
  callback?: function,
): Promise<void>

Schließt einen oder mehrere Tabs.

Parameter

  • tabIds

    number | number[]

    Die Tab-ID oder Liste der Tab-IDs, die geschlossen werden sollen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

removeCSS()

Promise Chrome 87 und höher &leq; MV2 Seit Chrome 91 eingestellt
chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
): Promise<void>

In Manifest V3 durch scripting.removeCSS ersetzt.

Entfernt CSS von einer Seite, das zuvor durch einen Aufruf von scripting.insertCSS eingefügt wurde.

Parameter

  • tabId

    number optional

    Die ID des Tabs, aus dem das CSS entfernt werden soll. Standardmäßig wird der aktive Tab des aktuellen Fensters verwendet.

  • Details zum zu entfernenden CSS-Text. Entweder der Code oder die Dateieigenschaft muss festgelegt werden, aber nicht beides gleichzeitig.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

sendMessage()

Promise 
chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
): Promise<any>

Sendet eine einzelne Nachricht an das/die Inhaltsskript(e) auf dem angegebenen Tab. Optional kann eine Callback-Funktion angegeben werden, die ausgeführt wird, wenn eine Antwort zurückgesendet wird. Das Ereignis runtime.onMessage wird in jedem Inhaltsscript ausgelöst, das auf dem angegebenen Tab für die aktuelle Erweiterung ausgeführt wird.

Parameter

  • tabId

    Zahl

  • Nachricht

    beliebig

    Die zu sendende Nachricht. Diese Nachricht sollte ein JSON-fähiges Objekt sein.

  • Optionen

    object optional

    • documentId

      String optional

      Chrome 106 und höher

      Senden einer Nachricht an ein bestimmtes Dokument, das durch documentId identifiziert wird, anstatt an alle Frames auf dem Tab.

    • frameId

      number optional

      Senden Sie eine Nachricht an einen bestimmten Frame, der durch frameId identifiziert wird, anstatt an alle Frames auf dem Tab.

  • callback

    Funktion optional

    Chrome 99 und höher

    Der Parameter callback sieht so aus: 

    (response: any) => void

    • Antwort

      beliebig

      Das JSON-Antwortobjekt, das vom Handler der Nachricht gesendet wird. Wenn beim Herstellen einer Verbindung zum angegebenen Tab ein Fehler auftritt, wird der Callback ohne Argumente aufgerufen und runtime.lastError wird auf die Fehlermeldung gesetzt.

Ausgabe

  • Promise<any>

    Chrome 99 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

sendRequest()

Promise &leq; MV2 Eingestellt
chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
): Promise<any>

Verwenden Sie runtime.sendMessage.

Sendet eine einzelne Anfrage an das/die Inhaltsskript(e) auf dem angegebenen Tab mit einem optionalen Callback, der ausgeführt wird, wenn eine Antwort zurückgesendet wird. Das Ereignis extension.onRequest wird in jedem Inhaltsscript ausgelöst, das auf dem angegebenen Tab für die aktuelle Erweiterung ausgeführt wird.

Parameter

  • tabId

    Zahl

  • Anfrage

    beliebig

  • callback

    Funktion optional

    Chrome 99 und höher

    Der Parameter callback sieht so aus: 

    (response: any) => void

    • Antwort

      beliebig

      Das JSON-Antwortobjekt, das vom Handler der Anfrage gesendet wird. Wenn beim Herstellen einer Verbindung zum angegebenen Tab ein Fehler auftritt, wird der Callback ohne Argumente aufgerufen und runtime.lastError wird auf die Fehlermeldung gesetzt.

Ausgabe

  • Promise<any>

    Chrome 99 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setZoom()

Promise 
chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
): Promise<void>

Zoomt einen angegebenen Tab.

Parameter

  • tabId

    number optional

    Die ID des Tabs, der gezoomt werden soll. Standardmäßig wird der aktive Tab des aktuellen Fensters verwendet.

  • zoomFactor

    Zahl

    Der neue Zoomfaktor. Mit dem Wert 0 wird der Tab auf den aktuellen Standardzoomfaktor festgelegt. Werte über 0 geben einen (möglicherweise nicht standardmäßigen) Zoomfaktor für den Tab an.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setZoomSettings()

Promise 
chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
): Promise<void>

Legt die Zoomeinstellungen für einen bestimmten Tab fest, die definieren, wie Zoomänderungen behandelt werden. Diese Einstellungen werden beim Aufrufen des Tabs auf die Standardeinstellungen zurückgesetzt.

Parameter

  • tabId

    number optional

    Die ID des Tabs, für den die Zoomeinstellungen geändert werden sollen. Standardmäßig wird der aktive Tab des aktuellen Fensters verwendet.

  • zoomSettings

    ZoomSettings

    Hier wird festgelegt, wie Zoomänderungen behandelt werden und in welchem Umfang.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

ungroup()

Promise Chrome 88 oder höher 
chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
): Promise<void>

Entfernt einen oder mehrere Tabs aus den entsprechenden Gruppen. Wenn Gruppen leer werden, werden sie gelöscht.

Parameter

  • tabIds

    number | [number, ...number[]]

    Die Tab-ID oder Liste der Tab-IDs, die aus den jeweiligen Gruppen entfernt werden sollen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

update()

Promise 
chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
): Promise<Tab | undefined>

Ändert die Eigenschaften eines Tabs. Attribute, die nicht in updateProperties angegeben sind, werden nicht geändert.

Parameter

  • tabId

    number optional

    Standardmäßig wird der ausgewählte Tab des aktuellen Fensters verwendet.

  • updateProperties

    Objekt

    • Aktiv

      boolean optional

      Gibt an, ob der Tab aktiv sein soll. Hat keinen Einfluss darauf, ob das Fenster den Fokus hat (siehe windows.update).

    • autoDiscardable

      boolean optional

      Chrome 54 und höher

      Gibt an, ob der Tab vom Browser automatisch verworfen werden soll, wenn die Ressourcen knapp sind.

    • hervorgehoben

      boolean optional

      Fügt den Tab zur aktuellen Auswahl hinzu oder entfernt ihn daraus.

    • stummgeschaltet

      boolean optional

      Chrome 45 und höher

      Gibt an, ob der Tab stummgeschaltet werden soll.

    • openerTabId

      number optional

      Die ID des Tabs, über den dieser Tab geöffnet wurde. Wenn angegeben, muss sich der Tab, auf dem der Link geöffnet wurde, im selben Fenster wie dieser Tab befinden.

    • Angepinnt

      boolean optional

      Gibt an, ob der Tab angepinnt werden soll.

    • ausgewählt

      boolean optional

      Eingestellt

      Verwenden Sie highlighted.

      Gibt an, ob der Tab ausgewählt werden soll.

    • URL

      String optional

      Eine URL, zu der der Tab navigieren soll. JavaScript-URLs werden nicht unterstützt. Verwenden Sie stattdessen scripting.executeScript.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab?: Tab) => void

    • Tabulatortaste

      Tab optional

      Details zum aktualisierten Tab Die Properties url, pendingUrl, title und favIconUrl sind nur im tabs.Tab-Objekt enthalten, wenn die Erweiterung die Berechtigung "tabs" oder Hostberechtigungen für die Seite hat.

Ausgabe

  • Promise<Tab | undefined>

    Chrome 88 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onActivated

chrome.tabs.onActivated.addListener(
  callback: function,
)

Wird ausgelöst, wenn sich der aktive Tab in einem Fenster ändert. Die URL des Tabs ist möglicherweise noch nicht festgelegt, wenn dieses Ereignis ausgelöst wird. Sie können jedoch auf „onUpdated“-Ereignisse warten, um benachrichtigt zu werden, wenn eine URL festgelegt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (activeInfo: object) => void

    • activeInfo

      Objekt

      • tabId

        Zahl

        Die ID des Tabs, der aktiv geworden ist.

      • windowId

        Zahl

        Die ID des Fensters, in dem sich der aktive Tab geändert hat.

onActiveChanged

&leq; MV2 Verworfen
chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Verwenden Sie tabs.onActivated.

Wird ausgelöst, wenn sich der ausgewählte Tab in einem Fenster ändert. Die URL des Tabs ist möglicherweise noch nicht festgelegt, wenn dieses Ereignis ausgelöst wird. Sie können jedoch auf tabs.onUpdated-Ereignisse warten, um benachrichtigt zu werden, wenn eine URL festgelegt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (tabId: number, selectInfo: object) => void

    • tabId

      Zahl

    • selectInfo

      Objekt

      • windowId

        Zahl

        Die ID des Fensters, in dem sich der ausgewählte Tab geändert hat.

onAttached

chrome.tabs.onAttached.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Tab an ein Fenster angehängt wird, z. B. weil er zwischen Fenstern verschoben wurde.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (tabId: number, attachInfo: object) => void

    • tabId

      Zahl

    • attachInfo

      Objekt

      • newPosition

        Zahl

      • newWindowId

        Zahl

onCreated

chrome.tabs.onCreated.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Tab erstellt wird. Die URL des Tabs und die Mitgliedschaft in der Tabgruppe sind möglicherweise noch nicht festgelegt, wenn dieses Ereignis ausgelöst wird. Sie können jedoch auf „onUpdated“-Ereignisse warten, um benachrichtigt zu werden, wenn eine URL festgelegt oder der Tab einer Tabgruppe hinzugefügt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (tab: Tab) => void

    • Tabulatortaste

      Tab

onDetached

chrome.tabs.onDetached.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Tab von einem Fenster getrennt wird, z. B. weil er zwischen Fenstern verschoben wurde.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (tabId: number, detachInfo: object) => void

    • tabId

      Zahl

    • detachInfo

      Objekt

      • oldPosition

        Zahl

      • oldWindowId

        Zahl

onHighlightChanged

&leq; MV2 Verworfen
chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Verwenden Sie tabs.onHighlighted.

Wird ausgelöst, wenn sich die hervorgehobenen oder ausgewählten Tabs in einem Fenster ändern.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (selectInfo: object) => void

    • selectInfo

      Objekt

      • tabIds

        number[]

        Alle hervorgehobenen Tabs im Fenster.

      • windowId

        Zahl

        Das Fenster, dessen Tabs sich geändert haben.

onHighlighted

chrome.tabs.onHighlighted.addListener(
  callback: function,
)

Wird ausgelöst, wenn sich die hervorgehobenen oder ausgewählten Tabs in einem Fenster ändern.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (highlightInfo: object) => void

    • highlightInfo

      Objekt

      • tabIds

        number[]

        Alle hervorgehobenen Tabs im Fenster.

      • windowId

        Zahl

        Das Fenster, dessen Tabs sich geändert haben.

onMoved

chrome.tabs.onMoved.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Tab in einem Fenster verschoben wird. Es wird nur ein Ereignis für die Bewegung ausgelöst, das den Tab darstellt, den der Nutzer direkt verschoben hat. Für die anderen Tabs, die als Reaktion auf den manuell verschobenen Tab verschoben werden müssen, werden keine Ereignisse ausgelöst. Dieses Ereignis wird nicht ausgelöst, wenn ein Tab zwischen Fenstern verschoben wird. Weitere Informationen finden Sie unter tabs.onDetached.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (tabId: number, moveInfo: object) => void

    • tabId

      Zahl

    • moveInfo

      Objekt

      • fromIndex

        Zahl

      • toIndex

        Zahl

      • windowId

        Zahl

onRemoved

chrome.tabs.onRemoved.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Tab geschlossen wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (tabId: number, removeInfo: object) => void

    • tabId

      Zahl

    • removeInfo

      Objekt

      • isWindowClosing

        boolean

        Wahr, wenn der Tab geschlossen wurde, weil das übergeordnete Fenster geschlossen wurde.

      • windowId

        Zahl

        Das Fenster, dessen Tab geschlossen wird.

onReplaced

chrome.tabs.onReplaced.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Tab aufgrund von Prerendering oder Instant durch einen anderen Tab ersetzt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (addedTabId: number, removedTabId: number) => void

    • addedTabId

      Zahl

    • removedTabId

      Zahl

onSelectionChanged

&leq; MV2 Verworfen
chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Verwenden Sie tabs.onActivated.

Wird ausgelöst, wenn sich der ausgewählte Tab in einem Fenster ändert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (tabId: number, selectInfo: object) => void

    • tabId

      Zahl

    • selectInfo

      Objekt

      • windowId

        Zahl

        Die ID des Fensters, in dem sich der ausgewählte Tab geändert hat.

onUpdated

chrome.tabs.onUpdated.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Tab aktualisiert wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (tabId: number, changeInfo: object, tab: Tab) => void

    • tabId

      Zahl

    • changeInfo

      Objekt

      • audible

        boolean optional

        Chrome 45 und höher

        Der neue hörbare Status des Tabs.

      • autoDiscardable

        boolean optional

        Chrome 54 und höher

        Der neue Status des Tabs, der automatisch verworfen werden kann.

      • verworfen

        boolean optional

        Chrome 54 und höher

        Der neue verworfene Status des Tabs.

      • favIconUrl

        String optional

        Die neue Favicon-URL des Tabs.

      • eingefroren

        boolean optional

        Chrome 132 und höher

        Der neue eingefrorene Status des Tabs.

      • groupId

        number optional

        Chrome 88 und höher

        Die neue Gruppe des Tabs.

      • mutedInfo

        MutedInfo optional

        Chrome 46 und höher

        Der neue Stummgeschaltet-Status des Tabs und der Grund für die Änderung.

      • Angepinnt

        boolean optional

        Der neue angepinnte Status des Tabs.

      • splitViewId

        number optional

        Chrome 140+

        Die neue geteilte Ansicht des Tabs.

      • Status

        TabStatus optional

        Der Ladestatus des Tabs.

      • Titel

        String optional

        Chrome 48 und höher

        Der neue Titel des Tabs.

      • URL

        String optional

        Die URL des Tabs, falls sie sich geändert hat.

    • Tabulatortaste

      Tab

onZoomChange

chrome.tabs.onZoomChange.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Tab gezoomt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      Objekt

      • newZoomFactor

        Zahl

      • oldZoomFactor

        Zahl

      • tabId

        Zahl

      • zoomSettings

        ZoomSettings