SyntaxError: import declarations may only appear at top level of a module - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

日本語

Remember language Learn more

SyntaxError: import declarations may only appear at top level of a module

JavaScript 例外 "import declarations may only appear at top level of a module" は、import 宣言がモジュールの最上位レベルにない場合に発生します。これは、import 宣言が他の構文（関数やブロックなど）を含むか、多くの場合で言えば、現在のファイルがモジュールとして扱われていないことが原因である可能性があります。

エラーメッセージ

SyntaxError: Cannot use import statement outside a module (V8-based) SyntaxError: import declarations may only appear at top level of a module (Firefox) SyntaxError: Unexpected identifier 'x'. import call expects one or two arguments. (Safari)

エラーの種類

SyntaxError

エラーの原因

関数やブロックなど、import 宣言が別の構造の中に含まれている場合が考えられます。import 宣言は、モジュールの最上位に記述する必要があります。モジュールを条件付きでインポートしたり、必要に応じて遅延インポートしたりしたい場合は、代わりに動的インポートを使用してください。

もし import がすでにコードの最上位にある場合は、そのファイルがモジュールとして解釈されていない可能性があります。ランタイムは、ファイルがモジュールであるかどうかを判断するために外部からのヒントを要求します。そのようなヒントを提供する方法はいくつかあります。

ファイルを HTML から直接読み込む場合は、<script> タグに type="module" 属性が設定されていることを確認してください。
ノードでファイルを実行する場合は、ファイルの拡張子が .mjs であるか、あるいは最も近い package.json ファイルに "type": "module" フィールドが含まれていることを確認してください。
ファイルをワーカーとして実行する場合は、Worker() コンストラクターを type: "module" オプションをつけて呼び出すようにしてください。
このファイルを別のモジュールからインポートしてください。

それ以外にも、原因として考えられるのは、コンパイラー（TypeScript など）をつけて import を記述している際に、誤ってソースファイルを実行してしまった場合です。import 宣言は通常、プログラムの先頭に現れるため、パーサーがまずこれを検知し、エラーを報告してしまうのです。必ずソースファイルをコンパイルし、コンパイルされたファイルを実行するようにしてください。

例

条件付きインポート

Python と同様に、他の構文の内部で import を使用することはできません。

js
if (writeOutput) {
  import fs from "fs"; // SyntaxError
}

import を最上位に移動するか、動的インポートを使用するかしてください。

js
if (writeOutput) {
  import("fs").then((fs) => {
    // use fs
  });
}

モジュールではないスクリプトでのインポート

HTML からスクリプトを読み込む場合は、必ず <script> タグに type="module" 属性を追加してください。

html

何らかの理由でスクリプトをモジュールに移行できない場合は、動的インポートを使用することができます。

js
async function main() {
  const myModule = await import("./my-module.js");
  // use myModule
}

main();

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2026年5月24日 by MDN contributors.

View this page on GitHub • Report a problem with this content