---
title: "Cannot use import statement outside a module をブラウザーと Node.js で解決する"
description: "SyntaxError: Cannot use import statement outside a module は、ファイルがクラシックスクリプトか CommonJS として実行されたことを示します。モジュールとして読み込めば、同じ import が動きます。"
canonical: "https://logbrew.co/ja/errors/cannot-use-import-statement-outside-a-module"
last_updated: "2026-11-21"
---

# Cannot use import statement outside a module をブラウザーと Node.js で解決する

`SyntaxError: Cannot use import statement outside a module` は、ファイルがクラシックスクリプトか CommonJS として実行されたことを示します。モジュールとして読み込めば、同じ `import` が動きます。

2026年11月21日 に Chrome 157、Safari 27.2、Node.js 22.18.0、@logbrew/browser 0.1.22 で検証

執筆 [Furkan Erday](https://github.com/furkanerday). Furkan Erday は LogBrew の創業者です。毎日 Claude Code と Codex を使って LogBrew を開発しています。

Canonical: https://logbrew.co/ja/errors/cannot-use-import-statement-outside-a-module

## 5 つの script タグが 1 つの `import` をどう扱ったか

| ページの読み込み方 | コードの実行 | LogBrew の問題 |
| --- | --- | --- |
| type なしの `<script src>` | いいえ | `SyntaxError` |
| インライン `<script>` | いいえ | `SyntaxError` |
| 別オリジンの `<script src>` | いいえ | `Error`、行 0 |
| `type="module"` のスクリプト内の SDK | いいえ | いいえ |
| `<script type="module">` | はい | エラーなし |

Chrome 157 と Safari 27.2 は、どのタグでも同じ結果でした。

## ファイルがクラシックスクリプトとして実行された場所を探す

### ファイルを読み込む script タグを確認する

タグに `type` 属性がないため、ブラウザーは `app.js` をクラシックスクリプトとして読み込みます。クラシックスクリプトでは `import` を使えません。Chrome 157 は、ファイルの 1 行目が実行される前に、1 行 1 列目で止まりました。インラインスクリプトでも同じメッセージが出ました。

```bash
<!-- index.html -->
<script src="/app.js"></script>

// app.js
import { pour } from "./tap.js";

pour("IPA");
```

出力

```text
Uncaught SyntaxError: Cannot use import statement outside a module
```

### Safari では同じファイルでも別のメッセージになる

Safari 27.2 は同じ `app.js` を読み込み、`SyntaxError: Unexpected token '{'. import call expects one or two arguments.` を投げました。このメッセージは `import()` の呼び出しについてのもので、モジュールには触れていません。原因も解決方法も同じです。

出力

```text
SyntaxError: Unexpected token '{'. import call expects one or two arguments.
```

### クラシックスクリプトの export も失敗する

export だけを書いたファイルをクラシックなタグで読み込むと、最初の `export` で止まります。Chrome は `Unexpected token 'export'`、Safari は `Unexpected keyword 'export'` と表示しました。どちらも、ページがモジュールをクラシックスクリプトとして読み込んだことを示します。

```bash
// tap.js, loaded with <script src="/tap.js"></script>
export function pour(beer) {
  document.body.dataset.poured = beer;
}
```

出力

```text
Uncaught SyntaxError: Unexpected token 'export'
```

### Node.js では package.json の type フィールドを確認する

Node.js 22.18.0 は、`package.json` に `"type": "commonjs"` があるときに同じメッセージを投げました。スタックは CommonJS ローダーの `wrapSafe` を通ります。`type` フィールドがないときは、Node.js はファイルをモジュールとして実行し、エラーの代わりに警告を出しました。

```bash
// package.json
{ "name": "lab", "type": "commonjs" }

// node app.js
import { pour } from "./tap.js";
```

出力

```text
import { pour } from "./tap.js";
^^^^^^

SyntaxError: Cannot use import statement outside a module
    at wrapSafe (node:internal/modules/cjs/loader:1620:18)
    at Module._compile (node:internal/modules/cjs/loader:1662:20)
```

## ファイルをモジュールとして読み込む

### script タグにモジュールの type を付ける

同じタグに `type="module"` を付けると、`app.js` とその `import` は Chrome 157 と Safari 27.2 で動きました。このとき `tap.js` はブラウザーが読み込みます。`tap.js` をクラシックなタグでも読み込んでいる場合は、そのタグを削除してください。そのタグは `export` で止まり続けます。

```bash
<script type="module" src="/app.js"></script>
```

### package.json でモジュールの type を設定する

`package.json` に `"type": "module"` を書くか、ファイル名を `.mjs` に変えます。どちらでも、警告なしでファイルが動きました。Node.js は `type` フィールドの値にかかわらず、`.mjs` ファイルをモジュール、`.cjs` ファイルを CommonJS として読み込みます。

```bash
// package.json
{ "name": "lab", "type": "module" }

// node app.js
```

出力

```text
poured IPA
```

### LogBrew SDK を先にクラシックスクリプトで読み込む

構文エラーはそのファイルのどの行よりも先に起きるため、エラーリスナーはその時点でページにある必要があります。ブラウザーはページを読み終えてからモジュールスクリプトを実行するので、モジュールスクリプトでは間に合いません。SDK を `<head>` のクラシックスクリプトに置くと、LogBrew はエラーを記録しました。SDK を `type="module"` のスクリプトに置くと、何も記録しませんでした。

```bash
// logbrew.ts
import { installLogBrewBrowser } from "@logbrew/browser";

installLogBrewBrowser({ clientKey: "LOGBREW_BROWSER_KEY" });

// bun build logbrew.ts --format=iife --outfile=public/logbrew.js
// index.html, in <head> before every other script:
// <script src="/logbrew.js"></script>
```

## 実際に試して確認したこと

`http://127.0.0.1:28180` で 1 ページを配信し、`@logbrew/browser` 0.1.22 を最初に読み込んだ状態で、Chrome 157 と Safari 27.2 で開きました。同じコードを 5 通りの方法で読み込み、`error` イベントから `error.message` を読みました。

Chrome は原因を示し、Safari は示しませんでした。どちらのブラウザーも、`type="module"` ではファイルを実行しました。別のオリジンのスクリプトでは `Script error.` だけが出て、ファイル名はなく、行は 0 でした。ブラウザーが別のオリジンのスクリプトの詳細を隠すためです。

Node.js 22.18.0 がエラーを出したのは `"type": "commonjs"` のときだけでした。`type` フィールドがないときはファイルを実行し、下の警告を出しました。

出力

```text
poured IPA
(node:37250) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///…/app.js is not specified and it doesn't parse as CommonJS.
Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
To eliminate this warning, add "type": "module" to /…/package.json.
```

|  | Chrome 157 | Safari 27.2 |
| --- | --- | --- |
| type なしの `<script src>` | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| type なしのインライン `<script>` | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `tap.js`（`export` あり）、クラシックなタグ | `Unexpected token 'export'` | `Unexpected keyword 'export'` |
| 別オリジンの `<script src>` | `Script error.` | `Script error.` |
| `<script type="module">` | 実行された | 実行された |

## クラシックスクリプトで import を使えない理由

MDN のこのエラーのページによると、`import` 宣言はモジュールの最上位でしか使えず、よくある原因はファイルがモジュールとして実行されていないことです。ブラウザーがファイルをモジュールとして読み込むのは、タグに `type="module"` があるときだけです。type がないとクラシックスクリプトとして解析し、最初の `import` で止まります。

クラシックスクリプトでも、関数呼び出しの `import()` は使えます。Safari のメッセージはこの呼び出しについてのものなので、モジュールではなく引数が足りないと報告します。

Node.js はファイルごとに判断します。まず拡張子を見て、次に最も近い `package.json` の `type` フィールドを見ます。Node.js のドキュメントによると、v22.7.0 と v20.19.0 以降では、`type` フィールドがなく CommonJS として解析できないファイルはモジュールとして実行されます。

nodejs/node#39353 は 2021 年に、`package.json` ではなくエントリーポイントで判断するよう求めました。この提案は 2022 年にクローズされました。`type` を設定するか `.mjs` を使えば、今も判断がはっきりし、警告も消えます。

1. `.mjs` `.cjs`
2. `package.json` `type`
3. `type` フィールドがないときの構文検出

- [nodejs/node#39353](https://github.com/nodejs/node/issues/39353) Detect require vs. import based on the entry point, not package.json. クローズ済み, コメント 45 件.

## LogBrew が記録する内容

SDK は構文エラーを、`Browser error: SyntaxError` という名前の問題 1 件として、グループ化キー `browser.error:SyntaxError` 付きで記録しました。問題にはファイルのパスと行があり、スタックフレームはなく、メッセージは `redacted` でした。SDK はエラーメッセージを送らないためです。

両方のブラウザーの import と export のエラーは、同じ 1 件の問題にまとまりました。キーにはエラーの型しか含まれないためです。どのファイルを直すかは `sourcePath` で分かります。別オリジンのスクリプトは、行 0 でファイルパスのない別の問題 `Browser error: Error` になりました。

SDK をモジュールスクリプトに置いたときは、同じページでも LogBrew は何も記録しませんでした。最後の手順のとおり、SDK は自分のコードより前にクラシックスクリプトで読み込んでください。

- `Browser error: SyntaxError`
  - `mechanism`: `browser.error`
  - `handled`: `false`
  - `sourcePath`: `/app.js`
  - `lineNumber`: `1`
  - スタックフレーム: 0
  - グループ化キー: `browser.error:SyntaxError`
  - メッセージ: `redacted`
- `Browser error: Error`
  - `lineNumber`: `0`
  - グループ化キー: `browser.error:Error`

## よくある質問

### Cannot use import statement outside a module はどういう意味ですか？

ファイルに `import` 宣言があるのに、ブラウザーではクラシックスクリプトとして、Node.js では CommonJS として実行されたという意味です。モジュールとして読み込めば解決します。

### ブラウザーではどう直せばよいですか？

ファイルを読み込む script タグに `type="module"` を付けます。私たちのテストでは、そのあと同じ `app.js` が Chrome 157 と Safari 27.2 で動きました。

### Node.js ではどう直せばよいですか？

`package.json` に `"type": "module"` を書くか、ファイル名を `.mjs` に変えます。v22.7.0 以降の Node.js は、`type` フィールドのないパッケージでもモジュール構文を検出し、警告を出します。

### Safari で別のエラーが出るのはなぜですか？

Safari 27.2 は同じファイルに対して `Unexpected token '{'. import call expects one or two arguments.` と報告しました。問題も解決方法も同じです。

### Unexpected token export はどういう意味ですか？

クラシックスクリプトでは `export` も使えません。Chrome は `Unexpected token 'export'`、Safari は `Unexpected keyword 'export'` と表示しました。そのファイルもモジュールとして読み込んでください。

## 解析に失敗したスクリプトをすべて確認

LogBrew のブラウザー SDK は、構文エラーをファイルと行付きで記録し、エラーの型ごとにまとめます。余裕のある無料プランで始められます。クレジットカードは不要です。

[無料で始める](https://logbrew.co/ja)

## 出典

- [MDN, SyntaxError: import declarations may only appear at top level of a module](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Errors/import_decl_module_top_level)
- [MDN, Using modules on the web](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules/Modules_on_the_web)
- [Node.js docs, Determining module system](https://nodejs.org/api/packages.html#determining-module-system)
- [nodejs/node#39353](https://github.com/nodejs/node/issues/39353)

## ほかのエラーの解決方法

- [メッセージ、ファイル、行を隠す Script error を解決する](https://logbrew.co/ja/errors/script-error)
- [Failed to fetch エラーを解決し、3 つの原因を見分ける](https://logbrew.co/ja/errors/failed-to-fetch)
- [Kotlin と Android の java.lang.NullPointerException をメッセージから解決する](https://logbrew.co/ja/errors/nullpointerexception)
- [Minified React error #418 と #185 を完全なメッセージと自分のコードの行から解決する](https://logbrew.co/ja/errors/minified-react-error)
- [AxiosError Network Error を解決し、3 つの原因のどれかを突き止める](https://logbrew.co/ja/errors/axios-network-error)
- [HTTP 499 エラーを解決し、どちらが待つのをやめたかを突き止める](https://logbrew.co/ja/errors/http-499)
- [再現したエラーとそれぞれの解決方法](https://logbrew.co/ja/errors)
