tabs.onActivated

Wird ausgelöst, wenn sich der aktive Tab in einem Fenster ändert. Beachten Sie, dass die URL des Tabs möglicherweise nicht festgelegt ist, wenn dieses Ereignis ausgelöst wird. Sie können jedoch tabs.onUpdated-Ereignisse abhören, um benachrichtigt zu werden, wenn eine URL festgelegt wird.

Syntax

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

Beendet das Abhören 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 abgehört wird, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird dieses 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, falls 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

Ereignisse der Tab-Aktivierung abhören und protokollieren:

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

browser.tabs.onActivated.addListener(handleActivated);

Beispiel-Erweiterungen

Browser-Kompatibilität

BCD tables only load in the browser

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