chrome.tabs

Beschreibung

Verwenden Sie die chrome.tabs API, um mit dem Tabsystem des Browsers zu interagieren. Sie können dieses API verwenden, um Tabs im Browser zu erstellen, zu ändern und neu anzuordnen.

Die Tabs API bietet nicht nur Funktionen zum Bearbeiten und Verwalten von Tabs, sondern kann auch Sprache des Tabs, machen Sie einen Screenshot und Kommunizieren Sie mit den Inhaltsskripten eines Tabs.

Berechtigungen

Für die meisten Funktionen sind keine Berechtigungen erforderlich. Beispiel: Neuen Tab erstellen, den Tab neu laden, zu einer anderen URL navigieren usw.

Es gibt drei Berechtigungen, die Entwickler bei der Arbeit mit der Tabs API beachten sollten.

Die „Tabs“ Berechtigung

Diese Berechtigung gewährt keinen Zugriff auf den Namespace chrome.tabs. Stattdessen werden sie gewährt einer Erweiterung die Möglichkeit, für vier Personen tabs.query() aufzurufen Sensible Eigenschaften in tabs.Tab-Instanzen: url, pendingUrl, title und favIconUrl

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

Hostberechtigungen erlauben es einer Erweiterung, die vier sensiblen Tabs eines übereinstimmenden Tabs zu lesen und abzufragen. tabs.Tab-Properties. Sie können auch direkt mit den übereinstimmenden Tabs interagieren, indem sie Methoden wie als tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() und tabs.removeCSS()

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

activeTab gewährt einer Erweiterung temporäre Hostberechtigung für den aktuellen Tab in auf einen Aufruf eines Nutzers. Im Gegensatz zu Hostberechtigungen löst activeTab keine Warnungen aus.

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

Anwendungsfälle

In den folgenden Abschnitten werden einige häufige Anwendungsfälle beschrieben.

Erweiterungsseite auf einem neuen Tab öffnen

Ein gängiges Muster für Erweiterungen besteht darin, eine Onboarding-Seite in einem neuen Tab zu öffnen, wenn die Erweiterung installiert haben. 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

Dieses Beispiel zeigt, wie der Service Worker einer Erweiterung den aktiven Tab aus dem aktuell fokussiertes Fenster (oder das zuletzt fokussierte Fenster, wenn keine Chrome-Fenster im Fokus sind) Dieses in der Regel als aktueller Tab des Nutzers betrachtet werden.

  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

Dieses Beispiel zeigt, wie eine Erweiterung den stummgeschalteten Status für einen bestimmten Tab aktivieren oder deaktivieren 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 beim Anklicken an die erste Position verschieben

In diesem Beispiel wird gezeigt, wie Sie einen Tab verschieben, während ein Ziehvorgang ausgeführt wird oder nicht. Während dieses Beispiel chrome.tabs.move verwendet, können Sie dasselbe Wartemuster für andere Aufrufe verwenden, bei denen Tabs geändert werden, während während der Ziehvorgang 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-Skript eines ausgewählten Tabs übergeben

Dieses Beispiel zeigt, wie der Service Worker einer Erweiterung über tabs.sendMessage() mit Inhaltsskripten auf bestimmten Browsertabs 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 zu Tabs API-Erweiterungen finden Sie hier:

Typen

MutedInfo

Chrome (ab Version 46)

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

Attribute

  • extensionId

    String optional

    Die ID der Erweiterung, die den stummgeschalteten Status geändert hat. Nicht festgelegt, wenn eine Erweiterung nicht der Grund war, warum die Stummschaltung zuletzt geändert wurde.

  • stummgeschaltet

    boolean

    Gibt an, ob der Tab stummgeschaltet ist (d. h., es wird kein Ton abgespielt). Der Tab ist möglicherweise stummgeschaltet, auch wenn er nicht abgespielt wurde oder gerade keinen Ton abspielt. Entspricht der Frage, ob die Stummschaltung Die Audioanzeige wird angezeigt.

  • reason

    MutedInfoReason optional

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

MutedInfoReason

Chrome (ab Version 46)

Ein Ereignis, das zu einer Änderung des stummgeschalteten Status geführt hat.

Enum

"user"
Durch eine Nutzereingabe wurde der stummgeschaltete Status festgelegt.

"capture"
Die Tabaufnahme wurde gestartet, wodurch eine Änderung des stummgeschalteten Zustands erzwungen wird.

"extension"
Durch eine durch das Feld "extensionId" gekennzeichnete Erweiterung wird der stummgeschaltete Status festgelegt.

Tab

Attribute

  • Aktiv

    boolean

    Gibt an, ob der Tab in seinem Fenster aktiv ist. Bedeutet nicht unbedingt, dass das Fenster fokussiert ist.

  • audible

    Boolescher Wert optional

    Chrome (ab Version 45)

    Gibt an, ob der Tab in den letzten Sekunden Ton ausgegeben hat (er ist jedoch möglicherweise nicht zu hören, wenn er ebenfalls stummgeschaltet ist). Entspricht der Angabe, ob das Audio für den Lautsprecher angezeigt wird.

  • autoDiscardable

    boolean

    Chrome (ab Version 54)

    Legt fest, ob der Tab bei geringen Ressourcen vom Browser automatisch verworfen werden kann.

  • verworfen

    boolean

    Chrome (ab Version 54)

    Gibt an, ob der Tab verworfen wurde. Ein verworfener Tab ist ein Tab, dessen Inhalte aus dem Arbeitsspeicher entladen wurden, aber noch in der Tableiste angezeigt werden. Der Inhalt wird bei der nächsten Aktivierung neu geladen.

  • favIconUrl

    String optional

    Die URL des Favicon des Tabs. Diese Property ist nur vorhanden, wenn das Manifest der Erweiterung die Berechtigung "tabs" enthält. Es kann auch ein leerer String sein, wenn der Tab geladen wird.

  • groupId

    Zahl

    Chrome (ab Version 88)

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

  • Höhe

    Zahl optional

    Die Höhe des Tabs in Pixeln.

  • hervorgehoben

    boolean

    Gibt an, ob der Tab hervorgehoben ist.

  • id

    Zahl optional

    Die ID des Tabs. Tab-IDs sind innerhalb einer Browsersitzung eindeutig. Unter bestimmten Umständen kann einem Tab keine ID zugewiesen werden. z. B. bei der Abfrage fremdsprachiger Tabs mit der sessions API. In diesem Fall kann eine Sitzungs-ID vorhanden sein. Die Tab-ID kann für Apps und Entwicklertools-Fenster auch auf chrome.tabs.TAB_ID_NONE festgelegt werden.

  • inkognito

    boolean

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

  • Index

    Zahl

    Der nullbasierte Index des Tabs innerhalb seines Fensters.

  • lastAccessed

    Zahl

    Chrome 121 oder höher

    Der letzte Zugriff auf den Tab, angegeben als Anzahl der Millisekunden seit der Epoche.

  • mutedInfo

    MutedInfo optional

    Chrome (ab Version 46)

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

  • openerTabId

    Zahl optional

    Die ID des Tabs, über den dieser Tab geöffnet wurde (sofern vorhanden). Diese Eigenschaft ist nur vorhanden, wenn der Tab zum Öffnenden noch vorhanden ist.

  • pendingUrl

    String optional

    Chrome 79 oder höher

    Die URL, zu der über den Tab navigiert wird, bevor ein Commit durchgeführt wurde. Diese Eigenschaft ist nur vorhanden, wenn das Manifest der Erweiterung die Berechtigung "tabs" enthält und eine Navigation ausstehend ist.

  • Angepinnt

    boolean

    Gibt an, ob der Tab angepinnt ist.

  • ausgewählt

    boolean

    <ph type="x-smartling-placeholder"></ph> Eingestellt

    Bitte verwende tabs.Tab.highlighted.

    Gibt an, ob der Tab ausgewählt ist.

  • sessionId

    String optional

    Die Sitzungs-ID, die zur eindeutigen Identifizierung eines Tabs verwendet wird, der über die sessions API abgerufen wird.

  • Status

    TabStatus optional

    Der Ladestatus des Tabs.

  • Titel

    String optional

    Der Titel des Tabs. Diese Property ist nur vorhanden, wenn das Manifest der Erweiterung die Berechtigung "tabs" enthält.

  • URL

    String optional

    Die letzte für den Commit durchgeführte URL des Hauptframes des Tabs. Dieses Attribut ist nur vorhanden, wenn das Manifest der Erweiterung die Berechtigung "tabs" enthält. Es kann ein leerer String sein, wenn für den Tab noch kein Commit durchgeführt wurde. Weitere Informationen finden Sie unter Tab.pendingUrl.

  • Breite

    Zahl optional

    Die Breite des Tabs in Pixeln.

  • windowId

    Zahl

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

TabStatus

Chrome (ab Version 44)

Der Ladestatus des Tabs.

Enum

"unloaded"

"Wird geladen"

"abgeschlossen"

WindowType

Chrome (ab Version 44)

Die Art des Fensters.

Enum

"normal"

"Popup"

"Panel"

"App"

"devtools"

ZoomSettings

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

Attribute

  • defaultZoomFactor

    Zahl optional

    Chrome (ab Version 43)

    Wird verwendet, um die Standard-Zoomstufe für den aktuellen Tab bei Aufrufen von "tabs.getZoomSettings" zurückzugeben.

  • Modus

    ZoomSettingsMode optional

    Definiert, wie Zoomänderungen gehandhabt werden, d.h., welche Entität für die tatsächliche Skalierung der Seite verantwortlich ist ist standardmäßig automatic.

  • Bereich

    ZoomSettingsScope optional

    Legt fest, ob Zoomänderungen für den Ursprung der Seite bestehen bleiben oder nur in diesem Tab wirksam werden; wird im automatic-Modus standardmäßig auf per-origin gesetzt, andernfalls auf per-tab.

ZoomSettingsMode

Chrome (ab Version 44)

Definiert, wie Zoomänderungen gehandhabt werden, d.h., welche Entität für die tatsächliche Skalierung der Seite verantwortlich ist ist standardmäßig automatic.

Enum

"automatic"
Zoomänderungen werden automatisch vom Browser übernommen.

"manual"
Überschreibt die automatische Verarbeitung von Zoomänderungen. Das onZoomChange-Ereignis wird weiterhin gesendet und es liegt in der Verantwortung der Erweiterung, auf dieses Ereignis zu warten und die Seite manuell zu skalieren. Dieser Modus unterstützt das Zoomen nach per-origin nicht und ignoriert daher die Zoomeinstellung scope und geht von per-tab aus.

"deaktiviert"
Deaktiviert das Zoomen auf dem Tab Der Tab wird auf die Standard-Zoomstufe zurückgesetzt und alle versuchten Zoomänderungen werden ignoriert.

ZoomSettingsScope

Chrome (ab Version 44)

Legt fest, ob Zoomänderungen für den Ursprung der Seite bestehen bleiben oder nur in diesem Tab wirksam werden; wird im automatic-Modus standardmäßig auf per-origin gesetzt, andernfalls auf per-tab.

Enum

"per-origin"
Zoomänderungen bleiben am Ursprung der gezoomten Seite bestehen, d.h., alle anderen Tabs, die zu diesem Ursprung navigiert werden, werden ebenfalls gezoomt. Darüber hinaus werden per-origin-Zoomänderungen mit dem Ursprung gespeichert. Das bedeutet, dass beim Navigieren zu anderen Seiten mit demselben Ursprung alle auf denselben Zoomfaktor gezoomt werden. Der Bereich per-origin ist nur im automatic-Modus verfügbar.

"Pro Tab"
Zoomänderungen werden nur auf diesem Tab übernommen. Zoomänderungen auf anderen Tabs wirken sich nicht auf die Zoomstufe dieses Tabs aus. Außerdem werden per-tab Zoomänderungen bei der Navigation zurückgesetzt. Beim Navigieren auf einem Tab werden Seiten immer mit den 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 (ab Version 46)

Eine ID, die angibt, dass kein Browsertab vorhanden ist.

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

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

Erfasst den sichtbaren Bereich des aktuell aktiven Tabs im angegebenen Fenster. Um diese Methode aufzurufen, muss die Erweiterung entweder die Berechtigung &lt;all_urls&gt; oder die Berechtigung activeTab haben. Neben Websites, auf die Erweiterungen normalerweise zugreifen können, lassen sich mit dieser Methode sensible Websites erfassen, die anderweitig eingeschränkt sind, einschließlich „chrome:-scheme“-Seiten und anderer Erweiterungen. Seiten und Daten: URLs. Diese sensiblen Websites können nur mit der ActiveTab-Berechtigung erfasst werden. Datei-URLs dürfen nur dann erfasst werden, wenn der Erweiterung Dateizugriff gewährt wurde.

Parameter

  • windowId

    Zahl optional

    Das Zielfenster. Die Standardeinstellung ist das aktuelle Fenster.

  • 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 dem 'src' zugewiesen werden Eigenschaft eines HTML-img-Elements, das angezeigt werden soll.

Gibt Folgendes zurück:

  • Promise&lt;string&gt;

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

connect()

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

Stellt eine Verbindung zu einem oder mehreren Content-Skripts im angegebenen Tab her. Das Ereignis runtime.onConnect wird in jedem Content-Script ausgelöst, das auf dem angegebenen Tab für die aktuelle Erweiterung ausgeführt wird. Weitere Informationen finden Sie unter Content-Skript-Nachrichten.

Parameter

  • tabId

    Zahl

  • connectInfo

    Objekt optional

    • documentId

      String optional

      Chrome 106 und höher

      Öffnen Sie einen Port zu einem bestimmten Dokument, das durch documentId identifiziert wird, anstatt zu allen Frames auf dem Tab.

    • frameId

      Zahl optional

      Öffnen Sie einen Port zu einem bestimmten Frame, der durch frameId identifiziert wird, anstatt zu allen Frames auf dem Tab.

    • Name

      String optional

      Wird für Inhaltsskripte, die das Verbindungsereignis überwachen, an onConnect übergeben.

Gibt Folgendes zurück:

  • Ein Port, der zur 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()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.create(
  createProperties: object,
  callback?: function,
)

Erstellt einen neuen Tab.

Parameter

  • createProperties

    Objekt

    • Aktiv

      Boolescher Wert optional

      Legt fest, ob der Tab zum aktiven Tab im Fenster wird. Dies hat keinen Einfluss darauf, ob das Fenster im Fokus ist (siehe windows.update). Die Standardeinstellung ist true.

    • Index

      Zahl optional

      Die Position, die der Tab im Fenster einnehmen soll. Der angegebene Wert muss zwischen null und der Anzahl der Tabs im Fenster liegen.

    • openerTabId

      Zahl optional

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

    • Angepinnt

      Boolescher Wert optional

      Legt fest, ob der Tab angepinnt werden soll. Die Standardeinstellung ist false.

    • ausgewählt

      Boolescher Wert optional

      <ph type="x-smartling-placeholder"></ph> Eingestellt

      Wählen Sie active aus.

      Legt fest, ob der Tab zum ausgewählten Tab im Fenster wird. Die Standardeinstellung ist true.

    • URL

      String optional

      Die URL, zu der der Tab anfangs aufgerufen wird. Vollständig qualifizierte URLs müssen ein Schema (z.B. "http://www.google.com", nicht "www.google.com". Relative URLs sind relativ zur aktuellen Seite innerhalb der Erweiterung. Die Standardeinstellung ist die Seite „Neuer Tab“.

    • windowId

      Zahl optional

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab: Tab) => void

    • Tabulatortaste

      Tab

      Der erstellte Tab.

Gibt Folgendes zurück:

  • Promise<Tab>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

detectLanguage()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

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

Parameter

  • tabId

    Zahl optional

    Die Standardeinstellung ist der aktive Tab des aktuellen Fensters.

  • 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 wird geprüft und der erste Nicht-NULL-Wert wird zurückgegeben, mit Ausnahme von Chinesisch (vereinfacht), für das zh-CN zurückgegeben wird. Bei einer unbekannten/nicht definierten Sprache wird und zurückgegeben.

Gibt Folgendes zurück:

  • Promise&lt;string&gt;

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

discard()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 54 und höher 
chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

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

Parameter

  • tabId

    Zahl optional

    Die ID des zu verwerfenden Tabs. Falls angegeben, wird der Tab verworfen, es sei denn, er ist aktiv oder bereits verworfen. Wenn keine Angabe gemacht wird, verwirft der Browser den am wenigsten wichtigen Tab. Dies kann fehlschlagen, wenn keine verworfenen Tabs vorhanden sind.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab?: Tab) => void

    • Tabulatortaste

      Tabulatortaste optional

      Den verworfenen Tab, wenn er erfolgreich verworfen wurde: nicht definiert.

Gibt Folgendes zurück:

  • Promise<Tabulatortaste | nicht definiert>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

duplicate()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)

Dupliziert einen Tab.

Parameter

  • tabId

    Zahl

    Die ID des zu duplizierenden Tabs.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab?: Tab) => void

    • Tabulatortaste

      Tabulatortaste optional

      Details zum duplizierten Tab. Das Objekt tabs.Tab enthält nicht url, pendingUrl, title und favIconUrl, wenn die Berechtigung "tabs" nicht angefordert wurde.

Gibt Folgendes zurück:

  • Promise<Tabulatortaste | nicht definiert>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

executeScript()

<ph type="x-smartling-placeholder"></ph> Versprechen &amp;leq; MV2 Eingestellt seit Chrome 91
chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Ersetzt durch scripting.executeScript in Manifest V3.

Fügt JavaScript-Code in eine Seite ein Weitere Informationen finden Sie im Dokument zu Content-Skripts im Abschnitt Programmatische Einschleusung.

Parameter

  • tabId

    Zahl optional

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

  • Details

    InjectDetails

    Details zum auszuführenden Skript. Es muss entweder der Code oder die Dateieigenschaft festgelegt werden. Beide können nicht gleichzeitig festgelegt werden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result?: any[]) => void

    • Ergebnis

      Beliebig[] optional

      Das Ergebnis des Skripts in jedem eingefügten Frame.

Gibt Folgendes zurück:

  • Promise&lt;any[] | nicht definiert>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

get()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.get(
  tabId: number,
  callback?: function,
)

Ruft Details zum angegebenen Tab ab.

Parameter

  • tabId

    Zahl

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab: Tab) => void

    • Tabulatortaste

      Tab

Gibt Folgendes zurück:

  • Promise<Tab>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getAllInWindow()

<ph type="x-smartling-placeholder"></ph> Versprechen &amp;leq; MV2 Eingestellt
chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

Bitte verwende tabs.query {windowId: windowId}.

Ruft Details zu allen Tabs im angegebenen Fenster ab.

Parameter

  • windowId

    Zahl optional

    Die Standardeinstellung ist das aktuelle Fenster.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tabs: Tab[]) => void

Gibt Folgendes zurück:

  • Promise<Tab[]>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getCurrent()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.getCurrent(
  callback?: function,
)

Ruft den Tab ab, über den dieser Skriptaufruf erfolgt. Gibt undefined zurück, wenn der Aufruf aus einem Nicht-Tab-Kontext erfolgt (z. B. einer Hintergrund- oder Pop-up-Ansicht).

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab?: Tab) => void

Gibt Folgendes zurück:

  • Promise<Tabulatortaste | nicht definiert>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getSelected()

<ph type="x-smartling-placeholder"></ph> Versprechen &amp;leq; MV2 Eingestellt
chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

Bitte verwende tabs.query {active: true}.

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

Parameter

  • windowId

    Zahl optional

    Die Standardeinstellung ist das aktuelle Fenster.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab: Tab) => void

    • Tabulatortaste

      Tab

Gibt Folgendes zurück:

  • Promise<Tab>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getZoom()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
)

Ruft den aktuellen Zoomfaktor eines angegebenen Tabs ab.

Parameter

  • tabId

    Zahl optional

    Die ID des Tabs, von dem der aktuelle Zoomfaktor abgerufen werden soll; ist standardmäßig der aktive Tab des aktuellen Fensters.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (zoomFactor: number) => void

    • zoomFactor

      Zahl

      Der aktuelle Zoomfaktor des Tabs.

Gibt Folgendes zurück:

  • Promise&lt;number&gt;

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getZoomSettings()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)

Ruft die aktuellen Zoomeinstellungen des angegebenen Tabs ab.

Parameter

  • tabId

    Zahl optional

    Die ID des Tabs, für den die aktuellen Zoomeinstellungen abgerufen werden sollen ist standardmäßig der aktive Tab des aktuellen Fensters.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (zoomSettings: ZoomSettings) => void

    • zoomSettings

      ZoomSettings

      Die aktuellen Zoomeinstellungen des Tabs.

Gibt Folgendes zurück:

  • Promise&lt;ZoomSettings&gt;

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

goBack()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 72 und höher 
chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

Kehre zur vorherigen Seite zurück, falls verfügbar.

Parameter

  • tabId

    Zahl optional

    Die ID des Tabs, mit dem Sie zurücknavigieren möchten. wird standardmäßig der ausgewählte Tab des aktuellen Fensters angezeigt.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

goForward()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 72 und höher 
chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

Gehen Sie zur nächsten Seite, falls verfügbar.

Parameter

  • tabId

    Zahl optional

    Die ID des Tabs, um vorwärts zu navigieren; wird standardmäßig der ausgewählte Tab des aktuellen Fensters angezeigt.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

group()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome (ab Version 88) 
chrome.tabs.group(
  options: object,
  callback?: function,
)

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

Parameter

  • Optionen

    Objekt

    • createProperties

      Objekt optional

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

      • windowId

        Zahl optional

        Das Fenster der neuen Gruppe. Die Standardeinstellung ist das aktuelle Fenster.

    • groupId

      Zahl optional

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

    • tabIds

      Zahl | [Zahl, ...Zahl[]]

      Die Tab-ID oder die 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.

Gibt Folgendes zurück:

  • Promise&lt;number&gt;

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

highlight()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

Hebt die vorgegebenen Tabs hervor und konzentriert sich auf den ersten Tab der Gruppe. Es wird keine Aktion angezeigt, wenn der angegebene Tab derzeit aktiv ist.

Parameter

  • highlightInfo

    Objekt

    • Tabs

      Zahl | Zahl[]

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

    • windowId

      Zahl optional

      Das Fenster mit den Tabs.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (window: Window) => void

    • Fenster

      Fenster

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

Gibt Folgendes zurück:

  • Promise&lt;windows.Window&gt;

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

insertCSS()

<ph type="x-smartling-placeholder"></ph> Versprechen &amp;leq; MV2 Eingestellt seit Chrome 91
chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Ersetzt durch scripting.insertCSS in Manifest V3.

CSS in eine Seite einfügen Mit dieser Methode eingefügte Stile können mit scripting.removeCSS entfernt werden. Weitere Informationen finden Sie im Dokument zu Content-Skripts im Abschnitt Programmatische Einschleusung.

Parameter

  • tabId

    Zahl optional

    Die ID des Tabs, in den das CSS eingefügt wird. ist standardmäßig der aktive Tab des aktuellen Fensters.

  • Details

    InjectDetails

    Details zum einzufügenden CSS-Text. Es muss entweder der Code oder die Dateieigenschaft festgelegt werden. Beide können nicht gleichzeitig festgelegt werden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

move()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
  callback?: function,
)

Verschiebt einen oder mehrere Tabs an eine neue Position innerhalb des Fensters oder in ein neues Fenster. Beachten Sie, dass Tabs nur in normale Fenster (window.type === "normal") und umgekehrt verschoben werden können.

Parameter

  • tabIds

    Zahl | Zahl[]

    Die Tab-ID oder die Liste der zu verschiebenden Tab-IDs.

  • moveProperties

    Objekt

    • Index

      Zahl

      Die Position, an die das Fenster verschoben werden soll. Verwenden Sie -1, um den Tab am Ende des Fensters zu platzieren.

    • windowId

      Zahl optional

      Die Standardeinstellung ist das Fenster, in dem sich der Tab derzeit befindet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

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

Gibt Folgendes zurück:

  • Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

query()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

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

Parameter

  • queryInfo

    Objekt

    • Aktiv

      Boolescher Wert optional

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

    • audible

      Boolescher Wert optional

      Chrome (ab Version 45)

      Gibt an, ob die Tabs hörbar sind.

    • autoDiscardable

      Boolescher Wert optional

      Chrome (ab Version 54)

      Legt fest, ob die Tabs vom Browser automatisch verworfen werden können, wenn die Ressourcen knapp werden.

    • currentWindow

      Boolescher Wert optional

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

    • verworfen

      Boolescher Wert optional

      Chrome (ab Version 54)

      Gibt an, ob Tabs verworfen werden. Ein verworfener Tab ist ein Tab, dessen Inhalte aus dem Arbeitsspeicher entladen wurden, aber noch in der Tableiste angezeigt werden. Der Inhalt wird bei der nächsten Aktivierung neu geladen.

    • groupId

      Zahl optional

      Chrome (ab Version 88)

      Die ID der Gruppe, in der sich die Tabs befinden, oder tabGroups.TAB_GROUP_ID_NONE bei nicht gruppierten Tabs.

    • hervorgehoben

      Boolescher Wert optional

      Gibt an, ob die Tabs hervorgehoben sind.

    • Index

      Zahl optional

      Die Position der Tabs innerhalb ihrer Fenster.

    • lastFocusedWindow

      Boolescher Wert optional

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

    • stummgeschaltet

      Boolescher Wert optional

      Chrome (ab Version 45)

      Gibt an, ob die Tabs stummgeschaltet sind.

    • Angepinnt

      Boolescher Wert optional

      Gibt an, ob die Tabs angepinnt sind.

    • Status

      TabStatus optional

      Ladestatus des Tabs.

    • Titel

      String optional

      Gleicht Seitentitel mit einem Muster ab. Diese Eigenschaft wird ignoriert, wenn die Erweiterung nicht die Berechtigung „"tabs"“ hat.

    • URL

      string | string[] optional

      Gleichen Sie Tabs mit einem oder mehreren URL-Mustern ab. Fragmentbezeichner werden nicht abgeglichen. Diese Eigenschaft wird ignoriert, wenn die Erweiterung nicht die Berechtigung „"tabs"“ hat.

    • windowId

      Zahl optional

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

    • windowType

      WindowType optional

      Die Art des Fensters, in dem sich die Tabs befinden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Tab[]) => void

Gibt Folgendes zurück:

  • Promise<Tab[]>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

reload()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

Aktualisieren Sie einen Tab.

Parameter

  • tabId

    Zahl optional

    Die ID des zu aktualisierenden Tabs. wird standardmäßig der ausgewählte Tab des aktuellen Fensters angezeigt.

  • reloadProperties

    Objekt optional

    • bypassCache

      Boolescher Wert optional

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

remove()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.remove(
  tabIds: number | number[],
  callback?: function,
)

Schließt einen oder mehrere Tabs.

Parameter

  • tabIds

    Zahl | Zahl[]

    Die Tab-ID oder die Liste der zu schließenden Tab-IDs.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

removeCSS()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 87 oder höher &amp;leq; MV2 Seit Chrome 91 eingestellt
chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Ersetzt durch scripting.removeCSS in Manifest V3.

Entfernt von einem Seiten-CSS-Code, der zuvor durch einen Aufruf von scripting.insertCSS eingeschleust wurde.

Parameter

  • tabId

    Zahl optional

    Die ID des Tabs, von dem das CSS entfernt werden soll ist standardmäßig der aktive Tab des aktuellen Fensters.

  • Details zum zu entfernenden CSS-Text. Es muss entweder der Code oder die Dateieigenschaft festgelegt werden. Beide können nicht gleichzeitig festgelegt werden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

sendMessage()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
)

Sendet eine einzelne Nachricht an die Inhaltsskripte auf dem angegebenen Tab mit einem optionalen Callback, der ausgeführt wird, wenn eine Antwort zurückgegeben wird. Das Ereignis runtime.onMessage wird in jedem Content-Script 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

    Objekt optional

    • documentId

      String optional

      Chrome 106 und höher

      Sendet eine Nachricht an ein bestimmtes Dokument mit documentId statt an alle Frames auf dem Tab.

    • frameId

      Zahl optional

      Sendet eine Nachricht an einen bestimmten Frame mit der Kennzeichnung frameId statt 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 vom Handler der Nachricht gesendete JSON-Antwortobjekt. 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.

Gibt Folgendes zurück:

  • Versprechen<beliebig>

    Chrome 99 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

sendRequest()

<ph type="x-smartling-placeholder"></ph> Versprechen &amp;leq; MV2 Eingestellt
chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)

Bitte verwende runtime.sendMessage.

Sendet eine einzelne Anforderung an die Inhaltsskripte 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 Content-Script 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 vom Handler der Anfrage gesendete JSON-Antwortobjekt. 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.

Gibt Folgendes zurück:

  • Versprechen<beliebig>

    Chrome 99 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

setZoom()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

Zoomt einen bestimmten Tab.

Parameter

  • tabId

    Zahl optional

    Die ID des Tabs, auf dem gezoomt werden soll. ist standardmäßig der aktive Tab des aktuellen Fensters.

  • zoomFactor

    Zahl

    Der neue Zoomfaktor Der Wert 0 legt für den Tab den aktuellen Standard-Zoomfaktor fest. 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

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

setZoomSettings()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

Legt die Zoomeinstellungen für einen angegebenen Tab fest, die definieren, wie Zoomänderungen verarbeitet werden. Diese Einstellungen werden beim Navigieren auf dem Tab auf die Standardeinstellungen zurückgesetzt.

Parameter

  • tabId

    Zahl optional

    ID des Tabs, für den die Zoomeinstellungen geändert werden sollen ist standardmäßig der aktive Tab des aktuellen Fensters.

  • zoomSettings

    ZoomSettings

    Definiert, wie und in welchem Umfang Zoomänderungen verarbeitet werden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

ungroup()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome (ab Version 88) 
chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
)

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

Parameter

  • tabIds

    Zahl | [Zahl, ...Zahl[]]

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

update()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
)

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

Parameter

  • tabId

    Zahl optional

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

  • updateProperties

    Objekt

    • Aktiv

      Boolescher Wert optional

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

    • autoDiscardable

      Boolescher Wert optional

      Chrome (ab Version 54)

      Legt fest, ob der Tab bei geringen Ressourcen vom Browser automatisch verworfen werden soll.

    • hervorgehoben

      Boolescher Wert optional

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

    • stummgeschaltet

      Boolescher Wert optional

      Chrome (ab Version 45)

      Legt fest, ob der Tab stummgeschaltet werden soll.

    • openerTabId

      Zahl optional

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

    • Angepinnt

      Boolescher Wert optional

      Legt fest, ob der Tab angepinnt werden soll.

    • ausgewählt

      Boolescher Wert optional

      <ph type="x-smartling-placeholder"></ph> Eingestellt

      Verwenden Sie hervorgehoben.

      Legt fest, ob der Tab ausgewählt werden soll.

    • URL

      String optional

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (tab?: Tab) => void

    • Tabulatortaste

      Tabulatortaste optional

      Details zum aktualisierten Tab. Das Objekt tabs.Tab enthält nicht url, pendingUrl, title und favIconUrl, wenn die Berechtigung "tabs" nicht angefordert wurde.

Gibt Folgendes zurück:

  • Promise<Tabulatortaste | nicht definiert>

    Chrome (ab Version 88)

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

Ereignisse

onActivated

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

Wird ausgelöst, wenn sich der aktive Tab in einem Fenster ändert. Beachten Sie, dass die URL des Tabs möglicherweise nicht zum Zeitpunkt des Auslösens dieses Ereignisses festgelegt war. Sie können jedoch onUpdated-Ereignisse überwachen, um beim Festlegen einer URL benachrichtigt zu werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (activeInfo: object) => void

    • activeInfo

      Objekt

      • tabId

        Zahl

        Die ID des aktiven Tabs.

      • windowId

        Zahl

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

onActiveChanged

<ph type="x-smartling-placeholder"></ph> &amp;leq; MV2 Eingestellt
chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Bitte verwende tabs.onActivated.

Wird ausgelöst, wenn sich der ausgewählte Tab in einem Fenster ändert. Beachten Sie, dass die URL des Tabs möglicherweise zum Zeitpunkt des Auslösens dieses Ereignisses nicht festgelegt war. Sie können jedoch auf tabs.onUpdated-Ereignisse warten, damit Sie beim Festlegen einer URL benachrichtigt werden.

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 ist weil es 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 Beachten Sie, dass die URL des Tabs und die Mitgliedschaft in der Tabgruppe möglicherweise nicht festgelegt sind, wenn das Ereignis ausgelöst wird. Sie können jedoch onUpdated-Ereignisse überwachen, 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 weil es 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

<ph type="x-smartling-placeholder"></ph> &amp;leq; MV2 Eingestellt
chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Bitte verwende tabs.onHighlighted.

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (selectInfo: object) => void

    • selectInfo

      Objekt

      • tabIds

        Zahl[]

        Alle markierten 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 markierten oder ausgewählten Tabs in einem Fenster ändern

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (highlightInfo: object) => void

    • highlightInfo

      Objekt

      • tabIds

        Zahl[]

        Alle markierten 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 innerhalb eines Fensters verschoben wird Es wird nur ein Verschiebungsereignis ausgelöst, das den Tab darstellt, den der Nutzer direkt verschoben hat. Verschiebungsereignisse werden nicht für die anderen Tabs ausgelöst, die als Reaktion auf den manuell verschobenen Tab verschoben werden müssen. 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

        Dieser Wert ist „True“, wenn der Tab geschlossen wurde, weil das übergeordnete Fenster geschlossen wurde.

      • windowId

        Zahl

        Das Fenster, dessen Tab geschlossen ist.

onReplaced

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

Wird ausgelöst, wenn ein Tab aufgrund von Pre-Rendering 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

<ph type="x-smartling-placeholder"></ph> &amp;leq; MV2 Eingestellt
chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Bitte verwende 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

        Boolescher Wert optional

        Chrome (ab Version 45)

        Der neue hörbare Status des Tabs.

      • autoDiscardable

        Boolescher Wert optional

        Chrome (ab Version 54)

        Der neue Status des Tabs, der automatisch entfernt werden kann

      • verworfen

        Boolescher Wert optional

        Chrome (ab Version 54)

        Der neue verworfene Status des Tabs.

      • favIconUrl

        String optional

        Die neue Favicon-URL des Tabs.

      • groupId

        Zahl optional

        Chrome (ab Version 88)

        Die neue Gruppe des Tabs.

      • mutedInfo

        MutedInfo optional

        Chrome (ab Version 46)

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

      • Angepinnt

        Boolescher Wert optional

        Der neue angepinnte Status des Tabs.

      • Status

        TabStatus optional

        Der Ladestatus des Tabs.

      • Titel

        String optional

        Chrome (ab Version 48)

        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