userScripts.configureWorld()
Konfiguriert die Ausführungsumgebungen von USER_SCRIPT
für die Erweiterung.
Änderungen an Weltkonfigurationen gelten nur für neue Instanzen der Welt: Eine Konfiguration wird nicht auf eine Welt angewendet, die durch die Ausführung eines Benutzerskripts in einem Dokument initialisiert wurde, bis das Dokument neu geladen wird. Der Browser kann jedoch bestimmte Rechte entziehen, wenn eine Konfiguration aktualisiert wird. Zum Beispiel können Nachrichtenaufrufe aus einer USER_SCRIPT
-Welt fehlschlagen, wenn die Erweiterung messaging
auf false
setzt.
Weltkonfigurationen bleiben bestehen, bis die Erweiterung aktualisiert oder die Konfiguration durch userScripts.resetWorldConfiguration()
zurückgesetzt wird.
Syntax
let configuredWorld = browser.userScripts.configureWorld(
properties // object
);
Parameter
properties
-
userScripts.WorldProperties
. Details der Konfiguration für eineUSER_SCRIPT
-Welt.Wenn
worldId
weggelassen wird oder die Zeichenkette leer ist, wird das Update auf die Standardwelt und alle Welten ohne explizite Konfiguration angewendet. WennworldId
spezifiziert wird, wird nur diese Welt konfiguriert.Beim Aktualisieren der Standardwelt und Welten ohne explizite Konfiguration werden bei Weglassen der Eigenschaften die Standardwerte von
userScripts.WorldProperties
verwendet.
Rückgabewert
Ein Promise
, das ohne Argumente erfüllt wird, wenn die Anfrage erfolgreich ist. Wenn die Anfrage fehlschlägt, wird das Promise mit einer Fehlermeldung abgelehnt.
Beispielerweiterungen
Browser-Kompatibilität
BCD tables only load in the browser