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

js
let resettingWorldConfiguration = browser.userScripts.resetWorldConfiguration(
  worldId       // optional string
);

Parameter

worldId Optional

string Die ID der USER_SCRIPT-Welt, die zurückgesetzt werden soll. Wenn weggelassen oder leer, wird die Konfiguration der Standardwelt und aller Welten ohne eine durch userScripts.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