tabs.onActivated

Wird ausgelöst, wenn sich der aktive Tab in einem Fenster ändert. Beachten Sie, dass die URL des Tabs möglicherweise zum Zeitpunkt der Auslösung dieses Ereignisses noch nicht festgelegt ist. Sie können jedoch auf tabs.onUpdated-Ereignisse lauschen, um benachrichtigt zu werden, wenn eine URL festgelegt wird.

Syntax

browser.tabs.onActivated.addListener(listener)
browser.tabs.onActivated.removeListener(listener)
browser.tabs.onActivated.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener): Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener): Stoppt das Lauschen dieses Ereignisses. Das Argument listener ist der zu entfernende Listener.
hasListener(listener): Überprüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es lauscht, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird folgendes Argument übergeben:

activeInfo: object. ID des Tabs, der aktiv gemacht wurde, und ID seines Fensters. Siehe den Abschnitt activeInfo für weitere Details.

Zusätzliche Objekte

activeInfo

previousTabId: integer. Die ID des zuvor aktivierten Tabs, wenn dieser Tab noch geöffnet ist.
tabId: integer. Die ID des Tabs, der aktiv geworden ist.
windowId: integer. Die ID des Fensters des Tabs.

Beispiele

Auf Tab-Aktivierungsereignisse lauschen und protokollieren:

function handleActivated(activeInfo) {
  console.log(`Tab ${activeInfo.tabId} was activated`);
}

browser.tabs.onActivated.addListener(handleActivated);

Beispielerweiterungen

Browser-Kompatibilität

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