BrowserSetting.onChange

Das BrowserSetting.onChange Ereignis wird ausgelöst, wenn die Einstellung geändert wird.

In Firefox wird es nicht ausgelöst, wenn die Änderung über about:config erfolgt ist.

Syntax

js
BrowserSetting.onChange.addListener(listener)
BrowserSetting.onChange.removeListener(listener)
BrowserSetting.onChange.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Hört auf, diesem Ereignis zuzuhören. Das listener Argument 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. Die Funktion wird mit folgenden Argumenten aufgerufen:

details

Ein object, das Details über die aufgetretene Änderung enthält. Seine Eigenschaften sind wie folgt:

value

Der neue Wert der Einstellung. Der Typ dieser Eigenschaft wird durch die spezielle Einstellung bestimmt.

levelOfControl

string. Dies gibt an, wie die Einstellung derzeit gesteuert wird. Sie können es verwenden, um zu überprüfen, ob Sie die Einstellung ändern können. Siehe BrowserSetting.set() für Details. Sein Wert kann einer der folgenden sein:

"not_controllable" Erweiterungen dürfen diese Einstellung nicht ändern.
"controlled_by_other_extensions" Eine andere Erweiterung, die nach dieser installiert wurde, hat diese Einstellung geändert.
"controllable_by_this_extension" Diese Erweiterung darf die Einstellung ändern.
"controlled_by_this_extension" Diese Erweiterung hat die Einstellung bereits geändert.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Hinweis: Diese API basiert auf der chrome.types API von Chromium.