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 vorgenommen wurde.
Syntax
BrowserSetting.onChange.addListener(listener)
BrowserSetting.onChange.removeListener(listener)
BrowserSetting.onChange.hasListener(listener)
Ereignisse haben drei Funktionen:
addListener(listener)-
Fügt einen Listener zu diesem Ereignis hinzu.
removeListener(listener)-
Stoppt das Lauschen auf dieses Ereignis. Das Argument
listenerist der zu entfernende Listener. hasListener(listener)-
Überprüft, ob
listenerfür dieses Ereignis registriert ist. Gibttruezurück, wenn es zuhört, andernfallsfalse.
Syntax von addListener
Parameter
listener-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis auftritt. Der Funktion werden folgende Argumente übergeben:
details-
Ein
object, das Details der aufgetretenen Änderung enthält. Seine Eigenschaften sind wie folgt:value-
Der neue Wert der Einstellung. Der Typ dieser Eigenschaft wird durch die jeweilige Einstellung bestimmt.
levelOfControl-
string. Dies stellt dar, wie die Einstellung derzeit kontrolliert wird. Sie können es verwenden, um zu prüfen, ob Sie die Einstellung ändern können. SieheBrowserSetting.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.
Beispiele
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromiums chrome.types API.