userScripts.register()

Registriert Benutzerskripte für die Erweiterung.

Syntax

js
let registeredUserScript = browser.userScripts.register(
  scripts       // array of objects
)

Parameter

scripts

array von userScripts.RegisteredUserScript. Details der zu registrierenden Benutzerskripte.

Jedes userScripts.RegisteredUserScript Objekt muss die js Eigenschaft als nicht-leeres Array und ein nicht-leeres Array entweder in matches oder includeGlobs enthalten.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn alle angeforderten Benutzerskripte registriert sind. Wenn es nicht gelingt, eines der Benutzerskripte zu registrieren oder die Anfrage aus einem anderen Grund fehlschlägt, werden keine Skripte registriert, und das Promise wird mit einer Fehlermeldung abgelehnt.

Beispiele

Dieses Snippet registriert den Hello-World-Code in der "myScriptId" Ausführungswelt, um auf allen Websites ausgeführt zu werden, die mit "*://example.com/*" übereinstimmen.

js
await browser.userScripts.register([
  {
    worldId: "myScriptId",
    js: [{ code: "console.log('Hello world!');" }],
    matches: ["*://example.com/*"],
  },
]);

Beispielerweiterungen

Browser-Kompatibilität

BCD tables only load in the browser