このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

import.source()

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

import.source() 構文は通常の import() 構文と同様に動作しますが、モジュールのコンパイル済みソースコードを表すオブジェクトで履行されるプロミスを返します。モジュールは取得およびコンパイルされますが、依存関係は読み込まれず、リンクも評価もされません。後から動的インポートやWebAssembly.instantiate()などを使って、明示的に評価できます。

import.source() を使用するには、対象のモジュールがソースフェーズのインポートに対応している必要があります。現在、ソースフェーズのインポートに対応しているのは WebAssembly モジュールのみであり、返されるのは WebAssembly.Module オブジェクトです。ECMAScript Module Phase Imports(英語) 提案により、JavaScript モジュールのソースオブジェクトも追加される予定です。

ソースフェーズのインポートの意味について詳しくは、import source 宣言形式を参照してください。

構文

js
import.source(moduleName)
import.source(moduleName, options)

import.source() は特殊な構文(「メタプロパティ」)であり、import オブジェクトのメソッドではありません。

引数

import()を参照してください。

返値

モジュールが正常に読み込まれてコンパイルされた後、そのコンパイル済みソースを表す AbstractModuleSource オブジェクトで履行されるプロミスを返します。

通常の import() と同様に、モジュールを読み込めない場合や構文解析できない場合、プロミスは拒否されます。モジュールの型がソースフェーズのインポートに対応していない場合も、SyntaxError で拒否されます。このインポートでは依存関係の読み込み、リンク、モジュールの評価を行わないため、それら後続の手順で発生するエラーは報告されません。

例

import.source() の使用

js
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

ブラウザーの互換性

関連情報