windows.onFocusChanged

Wird ausgelöst, wenn das aktuell fokussierte Fenster wechselt. Wird windows.WINDOW_ID_NONE sein, wenn alle Browserfenster den Fokus verloren haben.

Hinweis: In Windows und einigen Linux-Fenstermanagern wird WINDOW_ID_NONE immer unmittelbar vor einem Wechsel von einem Browserfenster zu einem anderen gesendet.

Syntax

js
browser.windows.onFocusChanged.addListener(listener)
browser.windows.onFocusChanged.removeListener(listener)
browser.windows.onFocusChanged.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Stoppt das Lauschen auf dieses Ereignis. Das Argument listener ist der zu entfernende Listener.

hasListener(listener)

Überprüft, ob ein listener für dieses Ereignis registriert ist. Gibt true zurück, wenn zugehört wird, andernfalls false.

Syntax von addListener

Parameter

listener

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

windowId

integer. ID des neu fokussierten Fensters.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Fokusänderungen protokollieren:

js
browser.windows.onFocusChanged.addListener((windowId) => {
  console.log(`Newly focused window: ${windowId}`);
});

Beispiel-Erweiterungen

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