userScripts.resetWorldConfiguration()
Setzt die Konfiguration einer USER_SCRIPT
-Welt, die durch userScripts.configureWorld
festgelegt wurde, auf die in userScripts.WorldProperties
spezifizierten Standardwerte zurück. Wenn die Standardwelt zurückgesetzt wird, werden auch alle Welten ohne explizite Konfiguration zurückgesetzt.
Änderungen an Weltkonfigurationen gelten nur für neue Instanzen der Welt: Eine Konfiguration wird erst dann auf eine Welt angewendet, die durch die Ausführung eines Benutzerskripts in einem Dokument initialisiert wurde, wenn das Dokument neu geladen wird. Der Browser kann jedoch bestimmte Berechtigungen widerrufen, wenn eine Konfiguration aktualisiert wird. Beispielsweise können Nachrichtenaufrufe aus einer USER_SCRIPT
-Welt fehlschlagen, wenn messaging
auf false
zurückgesetzt wird.
Syntax
let resettingWorldConfiguration = browser.userScripts.resetWorldConfiguration(
worldId // optional string
);
Parameter
worldId
Optional-
string
Die ID derUSER_SCRIPT
-Welt, die zurückgesetzt werden soll. Wenn weggelassen oder leer, wird die Konfiguration der Standardwelt und aller Welten ohne eine durchuserScripts.configureWorld
gesetzte Konfiguration zurückgesetzt.
Rückgabewert
Ein Promise
, das ohne Argumente erfüllt wird, wenn die Weltkonfiguration zurückgesetzt wird. Wenn die Anfrage fehlschlägt, wird das Promise mit einer Fehlermeldung abgelehnt.
Beispielerweiterungen
Browser-Kompatibilität
BCD tables only load in the browser