tabs.onAttached

Wird ausgelöst, wenn ein Tab an ein Fenster angehängt wird, zum Beispiel weil es zwischen Fenstern verschoben wurde.

Syntax

js
browser.tabs.onAttached.addListener(listener)
browser.tabs.onAttached.removeListener(listener)
browser.tabs.onAttached.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Beendet das Zuhören für dieses Ereignis. 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 zugehört wird, andernfalls false.

addListener Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden folgende Argumente übergeben:

tabId

integer. ID des Tabs, der an ein neues Fenster angehängt wurde.

attachInfo

object. ID des neuen Fensters und Index des Tabs innerhalb dieses. Siehe den Abschnitt attachInfo für weitere Details.

Zusätzliche Objekte

attachInfo

newWindowId

integer. ID des neuen Fensters.

newPosition

integer. Indexposition, die der Tab im neuen Fenster hat.

Beispiele

Hören Sie auf Attach-Ereignisse und protokollieren Sie die Information:

js
function handleAttached(tabId, attachInfo) {
  console.log(`Tab: ${tabId} attached`);
  console.log(`New window: ${attachInfo.newWindowId}`);
  console.log(`New index: ${attachInfo.newPosition}`);
}

browser.tabs.onAttached.addListener(handleAttached);

Browser-Kompatibilität

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