theme.onUpdated
Wird ausgelöst, wenn ein als Browser-Erweiterung bereitgestelltes Theme angewendet oder entfernt wird. Genauer:
- wenn ein statisches Theme installiert wird
- wenn ein dynamisches Theme entweder
theme.update()odertheme.reset()aufruft - wenn ein Theme deinstalliert wird.
Dieses Ereignis wird nicht ausgelöst, wenn sich die integrierten Themes ändern.
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)-
Beendet das Abhören dieses Ereignisses. Das Argument
listenerist der zu entfernende Listener. hasListener(listener)-
Überprüft, ob
listenerfür dieses Ereignis registriert ist. Gibttruezurück, wenn es lauscht, andernfallsfalse.
addListener Syntax
Parameter
listener-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden folgende 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 Theme angewendet wurde, handelt es sich um eintheme.Theme-Objekt, das das angewendete Theme darstellt. windowIdOptional-
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);