theme.onUpdated

Wird ausgelöst, wenn ein als Browser-Erweiterung bereitgestelltes Theme angewendet oder entfernt wird. Genauer gesagt:

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 eingebauten 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): Stoppt das Lauschen auf 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 es lauscht, 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 themenbasiertes Erweiterungsthema entfernt wurde, ist dies ein leeres Objekt. Wenn es ausgelöst wurde, weil ein themenbasiertes Erweiterungsthema 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

Browser-Kompatibilität

BCD tables only load in the browser