Fügt ein Benutzer-Skript in einen Zielkontext ein (z.B. Tab oder Frame).

Syntax

let executeUserScript = browser.userScripts.execute(  injection, // array of objects);

Parameter

injection

Ein Array von Objekten, die spezifizieren, welche Benutzer-Skripte wo und wie eingefügt werden sollen.

injectImmediatelyOptional

boolean. Wenn auftrue gesetzt, wird die Einfügung so schnell wie möglich im Zielkontext ausgeführt. Dies garantiert nicht, dass die Einfügung vor dem Laden der Seite erfolgt, da die Seite möglicherweise geladen wird, bevor das Skript das Ziel erreicht hat.

js

array vonuserScripts.ScriptSource. Die Skripte, die in die passenden Seiten eingefügt werden sollen.

target

Ein Objekt, das den Zielkontext definiert, in den Skripte eingefügt werden.

allFramesOptional

boolean. Wenn auftrue gesetzt, wird das Skript in alle verfügbaren Frames eingefügt. Standardmäßig auffalse, wobei das Skript nur in das oberste Frame eingefügt wird.

documentIdsOptional

array vonstring. Die IDs der Dokumente, in die eingefügt werden soll. Darf nicht angegeben werden, wennframeIds gesetzt ist.

frameIdsOptional

array voninteger. Die IDs der Frames, in die eingefügt werden soll. Darf nicht angegeben werden, wenndocumentIds gesetzt ist.

tabId

integer. Die ID eines Tabs, in den eingefügt werden soll.

worldOptional

userScripts.ExecutionWorld. Die Ausführungsumgebung, die verwendet wird, um die Skripte auszuführen. Standardmäßig"USER_SCRIPT".

worldIdOptional

string. ID einer Benutzer-Skript-Welt, in der das Skript ausgeführt wird. Nur gültig, wennworldUSER_SCRIPT ist oder weggelassen wird. WennworldId weggelassen wird, wird das Skript in der Standard-USER_SCRIPT-Welt ("") ausgeführt. Werte mit führenden Unterstrichen (_) sind reserviert. Die maximale Länge beträgt 256 Zeichen. Eine Welt kann von mehreren Skripten als Ausführungsumgebung genutzt werden. Um das Verhalten einer Welt zu konfigurieren, übergeben Sie derenworldId anuserScripts.configureWorld bevor das erste Skript in dieser Welt ausgeführt wird.

Rückgabewert

EinPromise, das mit einem Array von Objekten erfüllt wird, die das Ergebnis der Einfügung mit folgenden Eigenschaften beschreiben:

documentId

string. Dokument-ID, die mit der Einfügung verknüpft ist.

errorOptional

string. Fehlermeldung, falls vorhanden. Dies schließtresult aus.

frameId

integer. Frame-ID, die mit der Einfügung verknüpft ist.

resultOptional

string. Ergebnis der Skript-Einfügung, falls vorhanden. Dies schließterror aus.

Beispiele

await browser.userScripts.execute([  {    js: [{ code: "console.log('Hello world!');" }],    target: { tabId: 1 },  },]);

Browser-Kompatibilität