Worklet: addModule()-Methode

Syntax

addModule(moduleURL)
addModule(moduleURL, options)

Parameter

moduleURL

Ein String, der die URL einer JavaScript-Datei mit dem hinzuzufgenden Modul enthlt.

options Optional

Ein Objekt mit einer der folgenden Optionen:

credentials

Ein Request.credentials-Wert, der angibt, ob Anmeldeinformationen (z.B. Cookies und HTTP-Authentifizierung) beim Laden des Moduls gesendet werden sollen. Kann einer der Werte "omit", "same-origin" oder "include" sein. Standardmig auf "same-origin" gesetzt. Siehe auch Request.credentials.

Rckgabewert

Ein Promise, das aufgelst wird, sobald das Modul von der angegebenen URL hinzugefgt wurde. Das Versprechen gibt keinen Wert zurck.

Ausnahmen

Wenn addModule() fehlschlgt, lehnt es das Versprechen ab und bergibt einen der folgenden Fehler an den Ablehnungshandler.

AbortError DOMException

Das angegebene Skript ist ungltig oder konnte nicht geladen werden.

SyntaxError DOMException

Die angegebene moduleURL ist ungltig.

Beispiele

AudioWorklet-Beispiel

const audioCtx = new AudioContext();
const audioWorklet = audioCtx.audioWorklet;
audioWorklet.addModule("modules/bypassFilter.js", {
  credentials: "omit",
});

PaintWorklet-Beispiel

CSS.paintWorklet.addModule(
  "https://mdn.github.io/houdini-examples/cssPaint/intro/worklets/hilite.js",
);

Sobald das Skript zum paint worklet hinzugefgt wurde, kann die CSS-paint()-Funktion verwendet werden, um das vom Worklet erstellte Bild einzubinden:

@supports (background-image: paint(id)) {
  h1 {
    background-image: paint(hollow-highlights, filled, 3px);
  }
}

Spezifikationen

Browser-Kompatibilitt