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

Beispielerweiterungen

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
onActivated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

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