Метод Worklet: addModule()

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS), в некоторых или всех поддерживающих браузерах.

Метод addModule() интерфейса Worklet загружает модуль из указанного JavaScript-файла и добавляет его к текущему Worklet.

Синтаксис

addModule(moduleURL)
addModule(moduleURL, options)

Параметры

moduleURL

A String содержащий URL JavaScript-файла с модулем для добавления.

options Необязательно

Объект с любыми из следующих опций:

credentials: Значение Request.credentials, которое указывает, нужно ли отправлять данные авторизации (например, куки и HTTP-аутентификацию) при загрузке модуля. Может быть одним из "omit", "same-origin", или "include". По умолчанию "same-origin". См. также Request.credentials.

Возвращаемое значение

A Promise разрешающийся, когда модуль из указанного URL был добавлен. Обещание не возвращает никакого значения.

Исключения

Если addModule() завершается неудачно, оно отклоняет обещание, передавая одно из следующих ошибок обработчику отклонения.

AbortError DOMException: Указанный скрипт недействителен или не может быть загружен.
SyntaxError DOMException: Указанный moduleURL недействителен.

Примеры

Пример AudioWorklet

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

Пример PaintWorklet

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

После добавления скрипта в paint worklet, функция CSS paint() может быть использована для включения изображения, созданного worklet:

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

Спецификации

Спецификация
HTML # dom-worklet-addmodule-dev

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`addModule`	65	79	76	52	14.1	65	79	47	14.5	9.0	65

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Worklet/addModule