import.source()
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
import.source() 構文は通常の import() 構文と同様に動作しますが、モジュールのコンパイル済みソースコードを表すオブジェクトで履行されるプロミスを返します。モジュールは取得およびコンパイルされますが、依存関係は読み込まれず、リンクも評価もされません。後から動的インポートやWebAssembly.instantiate()などを使って、明示的に評価できます。
import.source() を使用するには、対象のモジュールがソースフェーズのインポートに対応している必要があります。現在、ソースフェーズのインポートに対応しているのは WebAssembly モジュールのみであり、返されるのは WebAssembly.Module オブジェクトです。ECMAScript Module Phase Imports(英語) 提案により、JavaScript モジュールのソースオブジェクトも追加される予定です。
ソースフェーズのインポートの意味について詳しくは、import source 宣言形式を参照してください。
構文
import.source(moduleName)
import.source(moduleName, options)
import.source() は特殊な構文(「メタプロパティ」)であり、import オブジェクトのメソッドではありません。
引数
import()を参照してください。
返値
モジュールが正常に読み込まれてコンパイルされた後、そのコンパイル済みソースを表す AbstractModuleSource オブジェクトで履行されるプロミスを返します。
通常の import() と同様に、モジュールを読み込めない場合や構文解析できない場合、プロミスは拒否されます。モジュールの型がソースフェーズのインポートに対応していない場合も、SyntaxError で拒否されます。このインポートでは依存関係の読み込み、リンク、モジュールの評価を行わないため、それら後続の手順で発生するエラーは報告されません。
例
>import.source() の使用
const myModuleSource = await import.source("./my-module.wasm");
const instance = await WebAssembly.instantiate(myModuleSource, {
env: { log: console.log },
});
const { exports } = instance;
仕様書
| 仕様書 |
|---|
| Source Phase Imports> # sec-left-hand-side-expressions> |