DieaddModule()-Methode derWorklet-Schnittstelle lädt das Modul in der angegebenen JavaScript-Datei und fügt es dem aktuellenWorklet hinzu.

Syntax

addModule(moduleURL)addModule(moduleURL, options)

Parameter

moduleURL

EinString, der die URL einer JavaScript-Datei mit dem hinzuzufügenden Modul enthält.

optionsOptional

Ein Objekt mit einer der folgenden Optionen:

credentials

EinRequest.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. Standardmäßig auf"same-origin" gesetzt. Siehe auchRequest.credentials.

Rückgabewert

EinPromise, das aufgelöst wird, sobald das Modul von der angegebenen URL hinzugefügt wurde. Das Versprechen gibt keinen Wert zurück.

Ausnahmen

WennaddModule() fehlschlägt, lehnt es das Versprechen ab und übergibt einen der folgenden Fehler an den Ablehnungshandler.

AbortErrorDOMException

Das angegebene Skript ist ungültig oder konnte nicht geladen werden.

SyntaxErrorDOMException

Die angegebenemoduleURL ist ungültig.

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 zumpaint worklet hinzugefügt 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-Kompatibilität