theme.onUpdated

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

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

Syntax

js
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

js
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

Browser-Kompatibilität

BCD tables only load in the browser