theme.onUpdated

Wird ausgelöst, wenn ein als Browsererweiterung bereitgestelltes Theme angewendet oder entfernt wird. Insbesondere:

wenn ein statisches Theme installiert wird
wenn ein dynamisches Theme theme.update() oder theme.reset() aufruft
wenn ein Theme deinstalliert wird.

Dieses Ereignis wird nicht für Änderungen an den integrierten Themes ausgelöst.

Syntax

browser.theme.onUpdated.addListener(listener)
browser.theme.onUpdated.removeListener(listener)
browser.theme.onUpdated.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener): Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener): Hört auf, dieses Ereignis zu verfolgen. 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 zuhört, andernfalls false.

`addListener`-Syntax

Parameter

listener

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

updateInfo

object. Ein Objekt, das zwei Eigenschaften enthält:

theme: object. Wenn das Ereignis ausgelöst wurde, weil ein von der Erweiterung bereitgestelltes Theme entfernt wurde, ist dies ein leeres Objekt. Wenn es ausgelöst wurde, weil ein von der Erweiterung bereitgestelltes Theme angewendet wurde, dann ist es ein theme.Theme-Objekt, das das angewendete Theme darstellt.
windowId Optional: integer. Die ID des Fensters, in dem das Theme aktualisiert wurde. Wenn diese Eigenschaft nicht vorhanden ist, wurde das Theme in allen Fenstern aktualisiert.

Beispiele

function handleUpdated(updateInfo) {
  if (updateInfo.theme.colors) {
    console.log(`Theme was applied: ${updateInfo.theme}`);
  } else {
    console.log(`Theme was removed`);
  }
}

browser.theme.onUpdated.addListener(handleUpdated);

Beispielerweiterungen

theme-integrated-sidebar