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 intabs.Tab
-Instanzen aufzurufen:url
,pendingUrl
,title
undfavIconUrl
.{ "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 wietabs.captureVisibleTab()
,tabs.executeScript()
,tabs.insertCSS()
undtabs.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östactiveTab
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"
});
}
});
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);
}
}
}
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:
Typen
MutedInfo
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
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öherGibt 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öherGibt an, ob der Tab automatisch vom Browser verworfen werden kann, wenn die Ressourcen knapp sind.
-
verworfen
boolean
Chrome 54 und höherGibt 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öherDie 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 aufchrome.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öherDer letzte Zugriff auf den Tab als Anzahl der Millisekunden seit der Epoche.
-
mutedInfo
MutedInfo optional
Chrome 46 und höherDer 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öherDie 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
EingestelltVerwenden 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 unterTab.pendingUrl
. -
Breite
Nummer optional
Die Breite des Tabs in Pixeln.
-
windowId
Zahl
Die ID des Fensters, das den Tab enthält.
TabStatus
Der Ladestatus des Tabs.
Enum
WindowType
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öherWird 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 aufper-origin
gesetzt, andernfalls aufper-tab
.
ZoomSettingsMode
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
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
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
Eine ID, die angibt, dass kein Browsertab vorhanden ist.
Wert
-1
TAB_INDEX_NONE
Index, der das Fehlen eines Tab-Index in „tab_strip“ darstellt.
Wert
-1
Methoden
captureVisibleTab()
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ückgabe
-
Versprechen<string>
Chrome 88 und höherPromise-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 oder 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ückgabe
-
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()
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 isttrue
. -
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
EingestelltVerwenden 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
-
Der Tab „Erstellt“.
-
Rückgabe
-
Promise<Tab>
Chrome 88 und höherPromise-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()
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
oderfr
. 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 daszh-CN
zurückgegeben wird. Für eine unbekannte/nicht definierte Sprache wirdund
zurückgegeben.
-
Rückgabe
-
Versprechen<string>
Chrome 88 und höherPromise-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()
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ückgabe
-
Promise<Tab | undefined>
Chrome 88 und höherPromise-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()
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 Objekttabs.Tab
nichturl
,pendingUrl
,title
undfavIconUrl
.
-
Rückgabe
-
Promise<Tab | undefined>
Chrome 88 und höherPromise-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()
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
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ückgabe
-
Promise<any[] | undefined>
Chrome 88 und höherPromise-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()
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
Rückgabe
-
Promise<Tab>
Chrome 88 und höherPromise-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()
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
-
Rückgabe
-
Promise<Tab[]>
Chrome 88 und höherPromise-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()
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ückgabe
-
Promise<Tab | undefined>
Chrome 88 und höherPromise-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()
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
Rückgabe
-
Promise<Tab>
Chrome 88 und höherPromise-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()
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ückgabe
-
Versprechen<Zahl>
Chrome 88 und höherPromise-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()
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
Die aktuellen Zoomeinstellungen des Tabs.
-
Rückgabe
-
Promise<ZoomSettings>
Chrome 88 und höherPromise-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()
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ückgabe
-
Promise<void>
Chrome 88 und höherPromise-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()
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ückgabe
-
Promise<void>
Chrome 88 und höherPromise-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()
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ückgabe
-
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()
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
Enthält Details über das Fenster, dessen Tabs hervorgehoben wurden.
-
Rückgabe
-
Promise<windows.Window>
Chrome 88 und höherPromise-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()
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
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ückgabe
-
Promise<void>
Chrome 88 und höherPromise-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()
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
Details zu den verschobenen Tabs
-
Rückgabe
-
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()
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öherGibt an, ob die Tabs hörbar sind.
-
autoDiscardable
Boolescher Wert optional
Chrome 54 und höherGibt 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öherGibt 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öherDie 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öherOb 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
-
Rückgabe
-
Promise<Tab[]>
Chrome 88 und höherPromise-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()
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ückgabe
-
Promise<void>
Chrome 88 und höherPromise-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()
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ückgabe
-
Promise<void>
Chrome 88 und höherPromise-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()
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
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ückgabe
-
Promise<void>
Chrome 88 und höherPromise-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()
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öherSenden 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öherDer 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ückgabe
-
Versprechen<any>
Chrome 99 oder höherPromise-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()
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
-
Anfrage
Beliebig
-
callback
Funktion optional
Chrome 99 oder höherDer 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ückgabe
-
Versprechen<any>
Chrome 99 oder höherPromise-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()
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 über0
geben einen (möglicherweise nicht standardmäßigen) Zoomfaktor für den Tab an. -
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgabe
-
Promise<void>
Chrome 88 und höherPromise-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()
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
Definiert, wie und in welchem Umfang Zoomänderungen verarbeitet werden.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgabe
-
Promise<void>
Chrome 88 und höherPromise-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()
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ückgabe
-
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()
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öherGibt 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öherLegt 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
EingestelltVerwenden 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 Objekttabs.Tab
nichturl
,pendingUrl
,title
undfavIconUrl
.
-
Rückgabe
-
Promise<Tab | undefined>
Chrome 88 und höherPromise-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
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.
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
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
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öherDer neue hörbare Status des Tabs.
-
autoDiscardable
Boolescher Wert optional
Chrome 54 und höherDer neue Status des Tabs, der automatisch verworfen werden kann.
-
verworfen
Boolescher Wert optional
Chrome 54 und höherDer neue verworfene Status des Tabs.
-
favIconUrl
String optional
Die neue Favicon-URL des Tabs.
-
groupId
Nummer optional
Chrome 88 und höherDie neue Gruppe des Tabs.
-
mutedInfo
MutedInfo optional
Chrome 46 und höherDer 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öherDer neue Titel des Tabs.
-
url
String optional
Die URL des Tabs, falls sie sich geändert hat.
-
-
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
-
-