---
title: "Cannot use import statement outside a module im Browser und in Node.js beheben"
description: "SyntaxError: Cannot use import statement outside a module heißt, die Datei lief als klassisches Skript oder als CommonJS. Lade sie als Modul, dann läuft dasselbe import."
canonical: "https://logbrew.co/de/errors/cannot-use-import-statement-outside-a-module"
last_updated: "2026-11-21"
---

# Cannot use import statement outside a module im Browser und in Node.js beheben

`SyntaxError: Cannot use import statement outside a module` heißt, die Datei lief als klassisches Skript oder als CommonJS. Lade sie als Modul, dann läuft dasselbe `import`.

Getestet am 21. November 2026 mit Chrome 157, Safari 27.2, Node.js 22.18.0 und @logbrew/browser 0.1.22

Von [Furkan Erday](https://github.com/furkanerday). Furkan Erday hat LogBrew gegründet. Er entwickelt LogBrew jeden Tag mit Claude Code und Codex.

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

## Was 5 Script-Tags mit 1 `import` gemacht haben

| Wie die Seite es geladen hat | Code lief | Issue in LogBrew |
| --- | --- | --- |
| `<script src>` ohne Typ | Nein | `SyntaxError` |
| Inline-`<script>` | Nein | `SyntaxError` |
| `<script src>` von einem anderen Origin | Nein | `Error`, Zeile 0 |
| SDK in einem `type="module"`-Skript | Nein | Nein |
| `<script type="module">` | Ja | Kein Fehler |

Chrome 157 und Safari 27.2 gaben für jedes Tag dasselbe Ergebnis.

## Finden, wo die Datei als klassisches Skript lief

### Das Script-Tag prüfen, das die Datei lädt

Das Tag hat kein `type`-Attribut, also liest der Browser `app.js` als klassisches Skript, und ein klassisches Skript kann kein `import` nutzen. Chrome 157 brach in Zeile 1, Spalte 1 ab, bevor irgendeine Zeile der Datei lief. Ein Inline-Skript gab dieselbe Meldung.

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

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

pour("IPA");
```

Ausgabe

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

### Safari meldet für dieselbe Datei etwas anderes

Safari 27.2 las dieselbe `app.js` und warf `SyntaxError: Unexpected token '{'. import call expects one or two arguments.` Die Meldung spricht von einem `import()`-Aufruf und erwähnt kein Modul. Ursache und Lösung sind dieselben.

Ausgabe

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

### Auch ein export in einem klassischen Skript schlägt fehl

Eine Datei, die nur exportiert und über ein klassisches Tag geladen wird, bricht beim ersten `export` ab. Chrome meldete `Unexpected token 'export'`, Safari `Unexpected keyword 'export'`. Beides heißt, dass die Seite ein Modul als klassisches Skript geladen hat.

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

Ausgabe

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

### In Node.js das type-Feld der package.json prüfen

Node.js 22.18.0 warf dieselbe Meldung, als in der `package.json` `"type": "commonjs"` stand. Der Stack läuft durch `wrapSafe` im CommonJS-Loader. Ohne `type`-Feld führte Node.js die Datei als Modul aus und gab stattdessen eine Warnung aus.

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

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

Ausgabe

```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)
```

## Die Datei als Modul laden

### Den Modultyp am Script-Tag setzen

Mit `type="module"` am selben Tag liefen `app.js` und ihr `import` in Chrome 157 und Safari 27.2. Der Browser lädt `tap.js` dann selbst. Lädt ein klassisches Tag `tap.js` zusätzlich, entferne dieses Tag, denn es bricht weiter bei `export` ab.

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

### Den Modultyp in der package.json setzen

Setze `"type": "module"` in der `package.json` oder benenne die Datei in `.mjs` um. Beides führte unsere Datei ohne Warnung aus. Node.js liest eine `.mjs`-Datei immer als Modul und eine `.cjs`-Datei als CommonJS, egal was im `type`-Feld steht.

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

// node app.js
```

Ausgabe

```text
poured IPA
```

### Das LogBrew-SDK zuerst in einem klassischen Skript laden

Ein Parse-Fehler tritt auf, bevor eine Zeile dieser Datei läuft, also muss der Fehler-Listener schon auf der Seite sein. Ein Modulskript führt der Browser erst aus, wenn er die Seite gelesen hat, also kommt es zu spät. Mit dem SDK in einem klassischen Skript im `<head>` hat LogBrew den Fehler aufgezeichnet. Mit dem SDK in einem `type="module"`-Skript nichts.

```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>
```

## Was wir beim Testen gesehen haben

Wir haben 1 Seite unter `http://127.0.0.1:28180` ausgeliefert und in Chrome 157 und Safari 27.2 geöffnet, mit `@logbrew/browser` 0.1.22 als erstem Skript. Denselben Code haben wir auf 5 Arten geladen und `error.message` aus dem `error`-Ereignis gelesen.

Chrome nannte die Ursache, Safari nicht. Mit `type="module"` lief die Datei in beiden Browsern. Ein Skript von einem anderen Origin gab nur `Script error.` aus, ohne Dateinamen und mit Zeile 0, weil der Browser die Details eines fremden Skripts verbirgt.

Node.js 22.18.0 warf den Fehler nur mit `"type": "commonjs"`. Ohne `type`-Feld führte es die Datei aus und gab die Warnung unten aus.

Ausgabe

```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 |
| --- | --- | --- |
| `<script src>` ohne Typ | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| Inline-`<script>` ohne Typ | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `tap.js` mit `export`, klassisches Tag | `Unexpected token 'export'` | `Unexpected keyword 'export'` |
| `<script src>` von einem anderen Origin | `Script error.` | `Script error.` |
| `<script type="module">` | Lief | Lief |

## Warum ein klassisches Skript kein import nutzen kann

Laut MDN-Seite zu diesem Fehler darf eine `import`-Deklaration nur auf oberster Ebene eines Moduls stehen, und meist läuft die Datei schlicht nicht als Modul. Ein Browser liest eine Datei nur dann als Modul, wenn ihr Tag `type="module"` hat. Ohne Typ liest er sie als klassisches Skript und bricht beim ersten `import` ab.

Ein klassisches Skript darf den Funktionsaufruf `import()` nutzen. Die Meldung von Safari bezieht sich auf diesen Aufruf und meldet deshalb ein fehlendes Argument statt eines fehlenden Moduls.

Node.js entscheidet pro Datei. Zuerst zählt die Dateiendung, dann das `type`-Feld der nächsten `package.json`. Laut Node.js-Doku läuft seit v22.7.0 und v20.19.0 eine Datei ohne `type`-Feld als Modul, wenn sie sich nicht als CommonJS lesen lässt.

nodejs/node#39353 forderte 2021, dass Node.js nach dem Einstiegspunkt entscheidet und nicht nach der `package.json`. Das Issue wurde 2022 geschlossen. Mit `type` oder `.mjs` ist die Wahl weiterhin eindeutig, und die Warnung verschwindet.

1. `.mjs` `.cjs`
2. `package.json` `type`
3. Syntaxerkennung, wenn kein `type`-Feld da ist

- [nodejs/node#39353](https://github.com/nodejs/node/issues/39353) Detect require vs. import based on the entry point, not package.json. Geschlossen, 45 Kommentare.

## Was LogBrew aufzeichnet

Das SDK hat jeden Parse-Fehler als 1 Issue namens `Browser error: SyntaxError` aufgezeichnet, mit dem Gruppierungsschlüssel `browser.error:SyntaxError`. Das Issue hatte Dateipfad und Zeile, keine Stack-Frames und die Meldung `redacted`, weil das SDK keine Fehlermeldungen sendet.

Die import- und export-Fehler aus beiden Browsern landeten in diesem 1 Issue, weil der Schlüssel nur den Fehlertyp enthält. Welche Datei du anpassen musst, zeigt `sourcePath`. Das Skript vom anderen Origin wurde ein eigenes Issue, `Browser error: Error`, mit Zeile 0 und ohne Dateipfad.

Mit dem SDK in einem Modulskript hat LogBrew für dieselbe Seite nichts aufgezeichnet. Lade das SDK in einem klassischen Skript vor deinem Code, wie im letzten Schritt.

- `Browser error: SyntaxError`
  - `mechanism`: `browser.error`
  - `handled`: `false`
  - `sourcePath`: `/app.js`
  - `lineNumber`: `1`
  - Stackframes: 0
  - Gruppierungsschlüssel: `browser.error:SyntaxError`
  - Meldung: `redacted`
- `Browser error: Error`
  - `lineNumber`: `0`
  - Gruppierungsschlüssel: `browser.error:Error`

## Häufige Fragen

### Was bedeutet Cannot use import statement outside a module?

Die Datei enthält eine `import`-Deklaration, lief aber im Browser als klassisches Skript oder in Node.js als CommonJS. Lade sie als Modul, dann ist der Fehler weg.

### Wie behebe ich den Fehler im Browser?

Setze `type="module"` an das Script-Tag, das die Datei lädt. In unserem Test lief dieselbe `app.js` danach in Chrome 157 und Safari 27.2.

### Wie behebe ich den Fehler in Node.js?

Setze `"type": "module"` in der `package.json` oder benenne die Datei in `.mjs` um. Seit v22.7.0 erkennt Node.js Modulsyntax auch in einem Paket ohne `type`-Feld und gibt eine Warnung aus.

### Warum zeigt Safari einen anderen Fehler?

Safari 27.2 meldete für dieselbe Datei `Unexpected token '{'. import call expects one or two arguments.` Es ist dasselbe Problem mit derselben Lösung.

### Was bedeutet Unexpected token export?

Auch `export` geht in einem klassischen Skript nicht. Chrome meldete `Unexpected token 'export'`, Safari `Unexpected keyword 'export'`. Lade auch diese Datei als Modul.

## Sieh jedes Skript, das nicht geparst werden kann

Das LogBrew-Browser-SDK zeichnet jeden Parse-Fehler mit Datei und Zeile auf, gruppiert nach Fehlertyp. Starte mit dem großzügigen kostenlosen Plan, ohne Kreditkarte.

[Kostenlos starten](https://logbrew.co/de)

## Quellen

- [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)

## Weitere Fehler beheben

- [Den Script error beheben, der Meldung, Datei und Zeile verbirgt](https://logbrew.co/de/errors/script-error)
- [Den Fehler Failed to fetch beheben und seine 3 Ursachen unterscheiden](https://logbrew.co/de/errors/failed-to-fetch)
- [java.lang.NullPointerException in Kotlin und Android aus der Meldung beheben](https://logbrew.co/de/errors/nullpointerexception)
- [Minified React error #418 und #185 beheben, mit der vollen Meldung und deiner Quellzeile](https://logbrew.co/de/errors/minified-react-error)
- [AxiosError Network Error beheben und herausfinden, welche der 3 Ursachen du hast](https://logbrew.co/de/errors/axios-network-error)
- [HTTP-Fehler 499 beheben und herausfinden, wer nicht mehr gewartet hat](https://logbrew.co/de/errors/http-499)
- [Fehler, die wir reproduziert haben, und wie du jeden behebst](https://logbrew.co/de/errors)
