chrome.tabs

Hinweis:Die Tabs API kann von den Service Worker- und Erweiterungsseiten verwendet werden, nicht aber von Inhaltsskripts.

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 die Sprache des Tabs erkennen, einen Screenshot erstellen und über die Inhaltsskripte eines Tabs kommunizieren.

Berechtigungen

Für die meisten Funktionen sind keine Berechtigungen erforderlich. Beispiele: Erstellen eines neuen Tabs, Neu laden eines Tabs oder Aufrufen einer anderen URL

Die drei Berechtigungen, die Entwickler bei der Arbeit mit der Tabs API kennen sollten, sind wichtig.

Die Berechtigung „Tabs“

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

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

Hostberechtigungen

Mit Hostberechtigungen kann eine Erweiterung die vier sensiblen tabs.Tab-Eigenschaften eines übereinstimmenden Tabs lesen und abfragen. Außerdem können sie über Methoden wie tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() und tabs.removeCSS() direkt mit den entsprechenden Tabs interagieren.

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

Die Berechtigung „activeTab“

activeTab gewährt einer Erweiterung als Reaktion auf einen Nutzeraufruf temporäre Hostberechtigungen für den aktuellen Tab. 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 in einem neuen Tab öffnen

Ein gängiges Muster für Erweiterungen besteht darin, bei der Installation der Erweiterung eine Onboarding-Seite in einem neuen Tab zu öffnen. Das folgende Beispiel zeigt, wie das funktioniert.

background.js:

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

Hinweis:Für dieses Beispiel sind keine Berechtigungen erforderlich.

Aktuellen Tab herunterladen

Dieses Beispiel zeigt, wie der Service Worker einer Erweiterung den aktiven Tab aus dem Fenster abrufen kann, auf dem der Fokus gerade liegt, oder aus dem Fenster, auf das der Fokus gerade angewendet wird, wenn kein Chrome-Fenster hervorgehoben ist. Dies kann man sich in der Regel als den aktuellen Tab des Nutzers vorstellen.

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

Angegebenen Tab stummschalten

In diesem Beispiel wird gezeigt, wie eine Erweiterung die Stummschaltung eines bestimmten Tabs ein- und ausschalten 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" }`);
    });
  }

Durch Anklicken den aktuellen Tab 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 in diesem Beispiel chrome.tabs.move verwendet wird, können Sie dasselbe Wartemuster für andere Aufrufe verwenden, die Tabs ändern, während ein Ziehen ausgeführt wird.

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

Wichtig:Mit „catch(error)“ in einem Promise kann verhindert werden, dass ein Fehler, der ansonsten „chrome.runtime.lastError“ verwendet wird, nicht deaktiviert wird.

  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 Inhaltsskript eines ausgewählten Tabs übergeben

Dieses Beispiel zeigt, wie der Service Worker einer Erweiterung über tabs.sendMessage() mit Inhaltsskripts in 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:

• Manifest V2 – Tabs API-Erweiterungen
• Manifest V3 – Tab-Manager

Typen

MutedInfo

Chrome 46 und höher

Der stummgeschaltete Tab und der Grund für die letzte Statusänderung

Attribute

• extensionId

  String optional

  Die ID der Erweiterung, durch die die Stummschaltung geändert wurde. Nicht festgelegt, wenn eine Erweiterung nicht der Grund für die letzte Änderung der Stummschaltung war.

• stummgeschaltet

  boolean

  Gibt an, ob der Tab stummgeschaltet ist, d. h., dass kein Ton abgespielt wird. Der Tab ist möglicherweise stummgeschaltet, auch wenn er nicht abgespielt wurde oder gerade kein Ton abgespielt wird. Entspricht, ob die Anzeige „Stummgeschaltet“ angezeigt wird.

• reason

  MutedInfoReason optional

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

MutedInfoReason

Chrome 46 und höher

Ein Ereignis, das zu einer Statusänderung bei der Stummschaltung geführt hat.

Enum

"user"
Die Stummschaltung wurde durch eine Nutzereingabeaktion festgelegt.

"Capture"
Die Tabaufnahme wurde gestartet. Dadurch wird eine Änderung des stummgeschalteten Status erzwungen.

"extension"
Eine Erweiterung, die durch das Feld "extensionId" identifiziert wird, legt die stummgeschaltete Erweiterung fest.

Tab

Attribute

• Aktiv

  boolean

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

• audible

  Boolescher Wert optional

  Chrome 45 und höher

  Gibt an, ob der Tab in den letzten Sekunden Ton erzeugt hat (aber eventuell nicht zu hören ist, wenn er stummgeschaltet ist). Entspricht, ob die Anzeige „Lautsprecheraudio“ angezeigt wird.

• autoDiscardable

  boolean

  Chrome 54 und höher

  Gibt an, ob der Tab automatisch vom Browser verworfen werden kann, wenn die Ressourcen knapp 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, aber weiterhin in der Tableiste angezeigt wird. Der Inhalt wird bei der nächsten Aktivierung neu geladen.

• favIconUrl

  String optional

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

• groupId

  Zahl

  Chrome 88 und höher

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

• Höhe

  Nummer optional

  Die Höhe des Tabs in Pixeln.

• hervorgehoben

  boolean

  Legt fest, ob der Tab hervorgehoben ist.

• id

  Nummer 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. wenn fremde Tabs über die sessions API abgefragt werden und in diesem Fall eine Sitzungs-ID vorhanden sein kann. Die Tab-ID kann für Fenster von Apps und Entwicklertools 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

  Nummer optional

  Chrome 121 und höher

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

• mutedInfo

  MutedInfo optional

  Chrome 46 und höher

  Der stummgeschaltete Tab und der Grund für die letzte Statusänderung

• openerTabId

  Nummer optional

  Gegebenenfalls die ID des Tabs, mit dem dieser Tab geöffnet wurde. Diese Eigenschaft ist nur vorhanden, wenn der geöffnete Tab noch vorhanden ist.

• pendingUrl

  String optional

  Chrome 79 und höher

  Die URL, die über den Tab aufgerufen wird, bevor der Commit durchgeführt wurde. Diese Eigenschaft ist nur vorhanden, wenn das Manifest der Erweiterung die Berechtigung "tabs" enthält 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 zur eindeutigen Identifizierung eines Tabs, der von der sessions API abgerufen wurde.

• status

  TabStatus optional

  Der Ladestatus des Tabs.

• Titel

  String optional

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

• url

  String optional

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

• Breite

  Nummer 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

WindowType

Chrome 44 und höher

Die Art des Fensters.

Enum

"normal"

"devtools"

ZoomSettings

Legt fest, wie und in welchem Umfang Zoomänderungen in einem Tab gehandhabt werden.

Attribute

• defaultZoomFactor

  Nummer optional

  Chrome 43 und höher

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

• Modus

  ZoomSettingsMode optional

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

• Bereich

  ZoomSettingsScope optional

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

ZoomSettingsMode

Chrome 44 und höher

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

Enum

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

"manual"
Überschreibt die automatische Verarbeitung von Zoomänderungen. Das onZoomChange-Ereignis wird trotzdem gesendet und die Erweiterung ist dafür verantwortlich, auf dieses Ereignis zu warten und die Seite manuell zu skalieren. Dieser Modus unterstützt das Zoomen per-origin nicht und ignoriert daher die Zoomeinstellung scope. Es wird von per-tab ausgegangen.

"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

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

Enum

"per-origin"
Zoomänderungen bleiben im Ursprung der gezoomten Seite erhalten, d.h., alle anderen Tabs, die zum selben Ursprung navigiert sind, werden ebenfalls gezoomt. Außerdem werden per-origin-Zoomänderungen mit dem Ursprung gespeichert. Das bedeutet, dass beim Aufrufen anderer Seiten mit demselben Ursprung alle Zoomfaktoren auf den gleichen Zoomfaktor herangezoomt werden. Der Bereich per-origin ist nur im Modus automatic verfügbar.

"pro Tab"
Zoomänderungen werden nur in diesem Tab übernommen und 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. Beim Navigieren auf einem Tab werden die Seiten immer mit den per-origin-Zoomfaktoren geladen.

Attribute

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 und höher

Die maximale Häufigkeit, mit der captureVisibleTab pro Sekunde aufgerufen werden kann. captureVisibleTab ist teuer und sollte nicht zu oft aufgerufen werden.

Wert

2

TAB_ID_NONE

Chrome 46 und höher

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

Wert

-1

TAB_INDEX_NONE

Chrome 123 oder höher

Index, der das Fehlen eines Tab-Index in „tab_strip“ darstellt.

Wert

-1

Methoden

captureVisibleTab()

Versprechen

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

Erfasst den sichtbaren Bereich des aktuell aktiven Tabs im angegebenen Fenster. Zum Aufrufen dieser Methode muss die Erweiterung entweder die Berechtigung <all_urls> oder die Berechtigung activeTab haben. Mit dieser Methode können Erweiterungen nicht nur Websites, auf die sie normalerweise zugreifen können, auch vertrauliche Websites erfassen, die ansonsten eingeschränkt sind, darunter chrome:-scheme-Seiten, Seiten anderer Erweiterungen und Daten: URLs. Diese Websites mit vertraulichen Inhalten können nur mit der Berechtigung „activeTab“ erfasst werden. Datei-URLs dürfen nur erfasst werden, wenn der Erweiterung Dateizugriff gewährt wurde.

Parameter

• windowId

  Nummer 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 der Eigenschaft „src“ eines HTML-img-Elements für die Anzeige zugewiesen werden.

Rückgaben

• Versprechen<string>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

connect()

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

Stellt eine Verbindung zu den Inhaltsskripten im angegebenen Tab her. Das Ereignis runtime.onConnect wird in jedem Inhaltsskript 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

  Objekt optional

  • documentId

    String optional

    Chrome 106 und höher

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

  • frameId

    Nummer optional

    Öffnen Sie einen Port für einen bestimmten Frame, der durch frameId und nicht mit allen Frames auf dem Tab identifiziert wird.

  • name

    String optional

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

Rückgaben

• runtime.Port

  Ein Port, über den mit den auf dem angegebenen Tab ausgeführten Inhaltsskripts kommuniziert werden kann. Das runtime.Port-Ereignis des Ports wird ausgelöst, wenn der Tab geschlossen wird oder nicht vorhanden ist.

create()

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 werden soll. Hat keinen Einfluss darauf, ob das Fenster fokussiert ist (siehe windows.update). Die Standardeinstellung ist true.

  • Index

    Nummer optional

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

  • openerTabId

    Nummer 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

    Eingestellt

    Verwenden Sie active.

    Legt fest, ob der Tab als ausgewählter Tab im Fenster verwendet werden soll. Die Standardeinstellung ist true.

  • url

    String optional

    Die URL, zu der Sie den Tab als Erstes aufrufen. Voll qualifizierte URLs müssen ein Schema (d.h. „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

    Nummer 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

  •  

    Tab

    Der Tab „Erstellt“.

Rückgaben

• Promise<Tab>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

detectLanguage()

Versprechen

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

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

Parameter

• tabId

  Nummer optional

  Die Standardeinstellung ist der aktive Tab des aktuellen Fensters.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (language: string)=>void

  • language

    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 überprüft und der erste Nicht-NULL-Wert wird zurückgegeben. Ausgenommen hiervon ist vereinfachtes Chinesisch, für das zh-CN zurückgegeben wird. Für eine unbekannte/nicht definierte Sprache wird und zurückgegeben.

Rückgaben

• Versprechen<string>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

discard()

Versprechen Chrome 54 oder höher

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

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

Parameter

• tabId

  Nummer optional

  Die ID des zu verwerfenden Tabs. Wenn angegeben, wird der Tab verworfen, sofern er nicht aktiv oder bereits verworfen ist. Wenn er weggelassen wird, verwirft der Browser den am wenigsten wichtigen Tab. Dieser Vorgang kann fehlschlagen, wenn keine verwerfbaren Tabs vorhanden sind.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (tab?: Tab)=>void

  •  

    Tabulatortaste optional

    Der verworfene Tab, wenn er erfolgreich verworfen wurde; nicht anders definiert

Rückgaben

• Versprechen<Tab|nicht definiert>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

duplicate()

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 optional

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

Rückgaben

• Versprechen<Tab|nicht definiert>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

executeScript()

Promise &leq; MV2 Seit Chrome 91 eingestellt

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

In Manifest V3 durch scripting.executeScript ersetzt.

JavaScript-Code in eine Seite einfügen Weitere Informationen finden Sie im Content-Script-Dokument im Abschnitt Programmatische Einschleusung.

Parameter

• tabId

  Nummer optional

  Die ID des Tabs, auf dem das Skript ausgeführt werden soll. 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, aber beides kann 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.

Rückgaben

• Versprechen<alle[]|nicht definiert>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

get()

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

  •  

    Tab

Rückgaben

• Promise<Tab>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getAllInWindow()

Promise &leq; MV2 Eingestellt

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

Verwenden Sie tabs.query {windowId: windowId}.

Ruft Details zu allen Tabs im angegebenen Fenster ab.

Parameter

• windowId

  Nummer optional

  Die Standardeinstellung ist das aktuelle Fenster.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (tabs: Tab[])=>void

  • Tabs

    Tabulatortaste[]

Rückgaben

• Promise<Tab[]>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getCurrent()

Versprechen

chrome.tabs.getCurrent(
  callback?: function,
)

Ruft den Tab ab, von dem dieser Skriptaufruf stammt. Gibt undefined zurück, wenn der Aufruf nicht über einen Tab erfolgt (z. B. eine Hintergrundseite oder Pop-up-Ansicht).

Parameter

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (tab?: Tab)=>void

  •  

    Tabulatortaste optional

Rückgaben

• Versprechen<Tab|nicht definiert>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getSelected()

Promise &leq; MV2 Eingestellt

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

Verwenden Sie tabs.query {active: true}.

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

Parameter

• windowId

  Nummer optional

  Die Standardeinstellung ist das aktuelle Fenster.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (tab: Tab)=>void

  •  

    Tab

Rückgaben

• Promise<Tab>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getZoom()

Versprechen

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

Ruft den aktuellen Zoomfaktor eines angegebenen Tabs ab.

Parameter

• tabId

  Nummer optional

  Die ID des Tabs, aus dem 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.

Rückgaben

• Versprechen<Zahl>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getZoomSettings()

Versprechen

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)

Ruft die aktuellen Zoomeinstellungen eines angegebenen Tabs ab.

Parameter

• tabId

  Nummer optional

  Die ID des Tabs, von dem die aktuellen Zoomeinstellungen abgerufen werden. 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.

Rückgaben

• Promise<ZoomSettings>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

goBack()

Versprechen Chrome 72 oder höher

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

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

Parameter

• tabId

  Nummer optional

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

Rückgaben

• Promise<void>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

goForward()

Versprechen Chrome 72 oder höher

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

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

Parameter

• tabId

  Nummer optional

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

Rückgaben

• Promise<void>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

group()

Versprechen Chrome 88 oder höher

chrome.tabs.group(
  options: object,
  callback?: function,
)

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

Parameter

• Optionen

  Objekt

  • createProperties

    Objekt optional

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

    • windowId

      Nummer optional

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

  • groupId

    Nummer 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 von 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.

Rückgaben

• Versprechen<Zahl>

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

highlight()

Versprechen

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

Markiert die angegebenen Tabs und legt den Fokus auf den ersten Tab der Gruppe. Keine Aktion, wenn der angegebene Tab derzeit aktiv ist

Parameter

• highlightInfo

  Objekt

  • Tabs

    Zahl|Zahl[]

    Ein oder mehrere zu markierende Indizes.

  • windowId

    Nummer optional

    Das Fenster mit den Tabs.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (window: Window)=>void

  • Fenster

    Fenster

    Enthält Details über das Fenster, dessen Tabs hervorgehoben wurden.

Rückgaben

• Promise<windows.Window>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

insertCSS()

Promise &leq; MV2 Seit Chrome 91 eingestellt

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

In Manifest V3 durch scripting.insertCSS ersetzt.

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

Parameter

• tabId

  Nummer optional

  Die ID des Tabs, in den die CSS eingefügt werden sollen. 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, aber beides kann nicht gleichzeitig festgelegt werden.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

Rückgaben

• Promise<void>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

move()

Versprechen

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

Verschiebt einen oder mehrere Tabs an eine neue Position im zugehörigen Fenster oder in ein neues Fenster. Tabs können nur in normale Fenster (window.type === "normal") verschoben werden.

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

    Nummer optional

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

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

  • Tabs

    Tabulatortaste|Tabulatortaste[]

    Details zu den verschobenen Tabs

Rückgaben

• Versprechen<Tab|Tabulatortaste[]>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

query()

Versprechen

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

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

Parameter

• queryInfo

  Objekt

  • Aktiv

    Boolescher Wert optional

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

  • audible

    Boolescher Wert optional

    Chrome 45 und höher

    Gibt an, ob die Tabs hörbar sind.

  • autoDiscardable

    Boolescher Wert optional

    Chrome 54 und höher

    Gibt an, ob die Tabs automatisch vom Browser verworfen werden können, wenn die Ressourcen knapp sind.

  • currentWindow

    Boolescher Wert optional

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

  • verworfen

    Boolescher Wert 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, aber weiterhin in der Tableiste angezeigt wird. Der Inhalt wird bei der nächsten Aktivierung neu geladen.

  • groupId

    Nummer 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

    Boolescher Wert optional

    Legt fest, ob die Tabs hervorgehoben werden.

  • Index

    Nummer optional

    Die Position der Tabs in ihren Fenstern.

  • lastFocusedWindow

    Boolescher Wert optional

    Legt fest, ob sich die Tabs im letzten fokussierten Fenster befinden.

  • stummgeschaltet

    Boolescher Wert optional

    Chrome 45 und höher

    Ob die Tabs stummgeschaltet sind

  • Angepinnt

    Boolescher Wert optional

    Ob die Tabs angepinnt sind

  • status

    TabStatus optional

    Der Ladestatus des Tabs.

  • Titel

    String optional

    Gleichen Sie 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

    Nummer 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

  • Ergebnis

    Tabulatortaste[]

Rückgaben

• Promise<Tab[]>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

reload()

Versprechen

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

Aktualisieren Sie einen Tab.

Parameter

• tabId

  Nummer optional

  ID des zu aktualisierenden Tabs. Standardmäßig der ausgewählte Tab des aktuellen Fensters.

• reloadProperties

  Objekt optional

  • bypassCache

    Boolescher Wert optional

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

Rückgaben

• Promise<void>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

remove()

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

Rückgaben

• Promise<void>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

removeCSS()

Promise Chrome 87 oder höher &leq; MV2 Seit Chrome 91 eingestellt

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

In Manifest V3 durch scripting.removeCSS ersetzt.

Entfernt den CSS-Code einer Seite, der zuvor durch einen Aufruf von scripting.insertCSS eingeschleust wurde.

Parameter

• tabId

  Nummer optional

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

• Details

  DeleteInjectionDetails

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

Rückgaben

• Promise<void>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

sendMessage()

Versprechen

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

Sendet eine einzelne Nachricht an die Inhaltsskripts auf dem angegebenen Tab mit einem optionalen Callback, der ausgeführt wird, wenn eine Antwort zurückgesendet wird. Das Ereignis runtime.onMessage wird in jedem Inhaltsskript 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 Objekt sein, über das eine JSON-Datei übertragen werden kann.

• Optionen

  Objekt optional

  • documentId

    String optional

    Chrome 106 oder höher

    Senden Sie eine Nachricht an ein bestimmtes Dokument, das durch documentId angegeben wird, anstatt an alle Frames auf dem Tab.

  • frameId

    Nummer optional

    Sende eine Nachricht an einen bestimmten Frame, der durch frameId identifiziert wird, und nicht an alle Frames auf dem Tab.

• callback

  Funktion optional

  Chrome 99 oder 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.

Rückgaben

• Versprechen<any>

  Chrome 99 oder höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

sendRequest()

Promise &leq; MV2 Eingestellt

chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)

Verwenden Sie runtime.sendMessage.

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

Parameter

• tabId

  Zahl

• Request

  Beliebig

• callback

  Funktion optional

  Chrome 99 oder 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.

Rückgaben

• Versprechen<any>

  Chrome 99 oder höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

setZoom()

Versprechen

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

Zoomt einen angegebenen Tab.

Parameter

• tabId

  Nummer optional

  ID des zu zoomenden Tabs. Standardmäßig der aktive Tab des aktuellen Fensters.

• zoomFactor

  Zahl

  Der neue Zoomfaktor. Durch den Wert 0 wird für den Tab der aktuelle Standard-Zoomfaktor 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

Rückgaben

• Promise<void>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

setZoomSettings()

Versprechen

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

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

Parameter

• tabId

  Nummer optional

  Die ID des Tabs, dessen Zoomeinstellungen geändert werden sollen. 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

Rückgaben

• Promise<void>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

ungroup()

Versprechen Chrome 88 oder höher

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

Rückgaben

• Promise<void>

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

update()

Versprechen

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
)

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

Parameter

• tabId

  Nummer optional

  Die Standardeinstellung ist der ausgewählte Tab des aktuellen Fensters.

• updateProperties

  Objekt

  • Aktiv

    Boolescher Wert optional

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

  • autoDiscardable

    Boolescher Wert optional

    Chrome 54 und höher

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

  • hervorgehoben

    Boolescher Wert optional

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

  • stummgeschaltet

    Boolescher Wert optional

    Chrome 45 und höher

    Legt fest, ob der Tab stummgeschaltet werden soll.

  • openerTabId

    Nummer optional

    Die ID des Tabs, über den dieser Tab geöffnet wurde. Wenn angegeben, muss sich der geöffnete 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

    Eingestellt

    Verwenden Sie markiert.

    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 optional

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

Rückgaben

• Versprechen<Tab|nicht definiert>

  Chrome 88 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

Veranstaltungen

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 festgelegt ist, als dieses Ereignis ausgelöst wurde. Sie können jedoch onUpdated-Ereignisse überwachen, um benachrichtigt zu werden, wenn eine URL festgelegt wurde.

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

&leq; MV2 Eingestellt

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 wurde möglicherweise nicht festgelegt, als dieses Ereignis ausgelöst wurde. Sie können aber auf tabs.onUpdated-Ereignisse warten, um benachrichtigt zu werden, wenn eine URL festgelegt wurde.

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 mit einem Fenster verbunden ist, 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 Beachten Sie, dass die URL des Tabs und die Mitgliedschaft in der Tabgruppe zum Zeitpunkt des Auslösens dieses Ereignisses möglicherweise noch nicht festgelegt wurden. 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

  •  

    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 Eingestellt

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

Verwenden Sie 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

      Nummer[]

      Alle markierten Tabs im Fenster.

    • windowId

      Zahl

      Das Fenster, dessen Tabs geändert wurden.

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

      Nummer[]

      Alle markierten Tabs im Fenster.

    • windowId

      Zahl

      Das Fenster, dessen Tabs geändert wurden.

onMoved

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

Wird ausgelöst, wenn ein Tab innerhalb eines Fensters verschoben wird Es wird nur ein Move-Ereignis ausgelöst, das den Tab darstellt, den der Nutzer direkt verschoben hat. Verschiebeereignisse 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

      „True“, wenn der Tab geschlossen wurde, weil sein übergeordnetes 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

&leq; MV2 Eingestellt

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

      Boolescher Wert optional

      Chrome 45 und höher

      Der neue hörbare Status des Tabs.

    • autoDiscardable

      Boolescher Wert optional

      Chrome 54 und höher

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

    • verworfen

      Boolescher Wert optional

      Chrome 54 und höher

      Der neue verworfene Status des Tabs.

    • favIconUrl

      String optional

      Die neue Favicon-URL des Tabs.

    • groupId

      Nummer optional

      Chrome 88 und höher

      Die neue Gruppe des Tabs.

    • mutedInfo

      MutedInfo optional

      Chrome 46 und höher

      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 48 und höher

      Der neue Titel des Tabs.

    • url

      String optional

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

  •  

    Tab

onZoomChange

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

Wird ausgelöst, wenn ein Tab vergrößert wird

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (ZoomChangeInfo: object)=>void

  • ZoomChangeInfo

    Objekt

    • newZoomFactor

      Zahl

    • oldZoomFactor

      Zahl

    • tabId

      Zahl

    • zoomSettings

      ZoomSettings