Worklet.addModule()

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

Worklet インタフェースで定義される addModule() メソッドを利用することで、指定したJavaScript ファイルで定義されるモジュールを Worklet にロードできます。

記法

addPromise = worklet.addModule(moduleURL);
addPromise = worklet.addModule(moduleURL, options);

パラメータ

moduleURL

追加するモジュールが定義されている JavaScript ファイルのURLを表す String。

options 省略可

次のオプションを指定するためのオブジェクト:

credentials: RequestCredentials に指定するモジュールのロードに必要なクレデンシャル情報 (例: cookies や HTTP 認証)。 "omit"、"same-origin"、 "include"のいずれかの値を指定します。デフォルト値は"same-origin"となっています。詳しくは Request.credentials を参照してください。

返り値

Promise オブジェクトが帰ります。このオブジェクトは、URLで指定されたモジュールがロードできた場合に受理状態になります。またコールバック関数は何の引数も与えられず呼び出されます。

使用例

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

仕様

仕様	状況	コメント
Worklets Level 1 addModule() の定義	草案

ブラウザ互換性

BCD tables only load in the browser