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

View in English Always switch to English

import.defer()

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

もっと多くのブラウザーがこの機能に対応してほしいですか? 理由を教えてください。

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

import.defer() 構文は通常の import() 構文と同様に動作しますが、結果として遅延評価されるモジュール名前空間オブジェクトで履行されるプロミスを返します。モジュールとその依存関係は事前に取得およびリンクされますが、それらの同期的な評価は名前空間のプロパティにアクセスされるまで遅延されます。

最上位の await との相互作用など、遅延評価について詳しくは、import defer 宣言形式を参照してください。

構文

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

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

引数

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

返値

モジュールグラフの読み込みとリンクが完了し、先行して評価される最上位の await の依存関係の評価がすべて完了した後、遅延評価されるモジュール名前空間オブジェクトで履行されるプロミスを返します。

通常の import() と同様に、モジュールまたはその依存関係を読み込み、構文解析、リンクできない場合、プロミスは拒否されます。先行して評価されるモジュールで例外が発生した場合も拒否されます。一方、遅延されたままの評価で発生するエラーは、評価を開始する名前空間の操作によって同期的に発生します。

例

import.defer() の使用

メモ: 遅延評価されるモジュール名前空間オブジェクトには then というプロパティが決して公開されないため、返されたプロミスを await しても、エクスポートされた then メソッドが誤って呼び出されることはありません。これは通常のモジュール名前空間オブジェクトに関する注意点です。

js
const ts = await import.defer("typescript");

function compilePath(path) {
  // typescript モジュールのサブグラフの評価はここで開始
  const program = ts.createProgram([path], {});
}

返された名前空間をすぐに分割代入しないでください。評価が開始されるためです。

js
const { createProgram } = await import.defer("typescript");
// typescript モジュールはこの時点で評価済み

仕様書

仕様書
Deferred Imports Evaluation
# sec-left-hand-side-expressions

ブラウザーの互換性

関連情報