---
title: "Napraw Cannot use import statement outside a module w przeglądarce i w Node.js"
description: "SyntaxError: Cannot use import statement outside a module znaczy, że plik uruchomił się jako klasyczny skrypt albo jako CommonJS. Wczytaj go jako moduł, a ten sam import zadziała."
canonical: "https://logbrew.co/pl/errors/cannot-use-import-statement-outside-a-module"
last_updated: "2026-11-21"
---

# Napraw Cannot use import statement outside a module w przeglądarce i w Node.js

`SyntaxError: Cannot use import statement outside a module` znaczy, że plik uruchomił się jako klasyczny skrypt albo jako CommonJS. Wczytaj go jako moduł, a ten sam `import` zadziała.

Przetestowane 21 listopada 2026 z użyciem Chrome 157, Safari 27.2, Node.js 22.18.0 i @logbrew/browser 0.1.22

Autor [Furkan Erday](https://github.com/furkanerday). Furkan Erday jest założycielem LogBrew. Codziennie rozwija LogBrew z pomocą Claude Code i Codex.

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

## Co 5 tagów script zrobiło z 1 `import`

| Jak strona go wczytała | Kod zadziałał | Problem w LogBrew |
| --- | --- | --- |
| `<script src>` bez typu | Nie | `SyntaxError` |
| `<script>` inline | Nie | `SyntaxError` |
| `<script src>` z innego źródła | Nie | `Error`, wiersz 0 |
| SDK w skrypcie `type="module"` | Nie | Nie |
| `<script type="module">` | Tak | Brak błędu |

Chrome 157 i Safari 27.2 dały ten sam wynik dla każdego tagu.

## Ustal, gdzie plik uruchomił się jako klasyczny skrypt

### Sprawdź tag script, który wczytuje plik

Tag nie ma atrybutu `type`, więc przeglądarka czyta `app.js` jako klasyczny skrypt, a klasyczny skrypt nie może używać `import`. Chrome 157 zatrzymał się w wierszu 1, kolumnie 1, zanim uruchomił jakikolwiek wiersz pliku. Skrypt inline dał ten sam komunikat.

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

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

pour("IPA");
```

Wynik

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

### Safari podaje inny komunikat dla tego samego pliku

Safari 27.2 przeczytał ten sam `app.js` i rzucił `SyntaxError: Unexpected token '{'. import call expects one or two arguments.` Komunikat mówi o wywołaniu `import()` i nie wspomina o module. Przyczyna i rozwiązanie są te same.

Wynik

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

### Export w klasycznym skrypcie też zawodzi

Plik, który tylko eksportuje, wczytany klasycznym tagiem, zatrzymuje się na pierwszym `export`. Chrome zgłosił `Unexpected token 'export'`, a Safari `Unexpected keyword 'export'`. Oba znaczą, że strona wczytała moduł jako klasyczny skrypt.

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

Wynik

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

### W Node.js sprawdź pole type w package.json

Node.js 22.18.0 rzucił ten sam komunikat, gdy `package.json` miał `"type": "commonjs"`. Stos przechodzi przez `wrapSafe` w loaderze CommonJS. Bez pola `type` Node.js uruchomił plik jako moduł i zamiast błędu wypisał ostrzeżenie.

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

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

Wynik

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

## Wczytaj plik jako moduł

### Dodaj typ module do tagu script

Z `type="module"` na tym samym tagu `app.js` i jego `import` zadziałały w Chrome 157 i Safari 27.2. Przeglądarka sama wczytuje wtedy `tap.js`. Jeśli klasyczny tag też wczytuje `tap.js`, usuń go, bo nadal zatrzymuje się na `export`.

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

### Ustaw typ module w package.json

Ustaw `"type": "module"` w `package.json` albo zmień nazwę pliku na `.mjs`. Oba sposoby uruchomiły nasz plik bez ostrzeżenia. Node.js czyta plik `.mjs` jako moduł, a plik `.cjs` jako CommonJS, bez względu na pole `type`.

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

// node app.js
```

Wynik

```text
poured IPA
```

### Wczytaj SDK LogBrew najpierw w klasycznym skrypcie

Błąd parsowania pojawia się, zanim uruchomi się jakikolwiek wiersz tego pliku, więc nasłuchiwacz błędów musi już być na stronie. Przeglądarka uruchamia skrypt modułu dopiero po przeczytaniu strony, więc jest za późno. Z SDK w klasycznym skrypcie w `<head>` LogBrew zapisał błąd. Z SDK w skrypcie `type="module"` nie zapisał nic.

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

## Co zobaczyliśmy podczas testu

Udostępniliśmy 1 stronę pod `http://127.0.0.1:28180` i otworzyliśmy ją w Chrome 157 i Safari 27.2, z `@logbrew/browser` 0.1.22 wczytanym jako pierwszy. Ten sam kod wczytaliśmy na 5 sposobów i odczytaliśmy `error.message` ze zdarzenia `error`.

Chrome podał przyczynę, Safari nie. Obie przeglądarki uruchomiły plik z `type="module"`. Skrypt z innego źródła dał tylko `Script error.`, bez nazwy pliku i z wierszem 0, bo przeglądarka ukrywa szczegóły skryptu z innego źródła.

Node.js 22.18.0 dał błąd tylko z `"type": "commonjs"`. Bez pola `type` uruchomił plik i wypisał ostrzeżenie poniżej.

Wynik

```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>` bez typu | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `<script>` inline bez typu | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `tap.js` z `export`, klasyczny tag | `Unexpected token 'export'` | `Unexpected keyword 'export'` |
| `<script src>` z innego źródła | `Script error.` | `Script error.` |
| `<script type="module">` | Zadziałał | Zadziałał |

## Dlaczego klasyczny skrypt nie może używać import

Strona MDN o tym błędzie mówi, że deklaracja `import` może stać tylko na najwyższym poziomie modułu, a zwykłą przyczyną jest plik, który nie działa jako moduł. Przeglądarka czyta plik jako moduł tylko wtedy, gdy tag ma `type="module"`. Bez typu parsuje go jako klasyczny skrypt i zatrzymuje się na pierwszym `import`.

Klasyczny skrypt może używać wywołania funkcji `import()`. Komunikat Safari mówi o tym wywołaniu, więc zgłasza brak argumentu, a nie brak modułu.

Node.js decyduje dla każdego pliku osobno. Najpierw patrzy na rozszerzenie, potem na pole `type` najbliższego `package.json`. Według dokumentacji Node.js od v22.7.0 i v20.19.0 plik bez pola `type`, który nie parsuje się jako CommonJS, działa jako moduł.

nodejs/node#39353 prosiło w 2021 roku, by Node.js wybierał według punktu wejścia, a nie według `package.json`. Zgłoszenie zamknięto w 2022 roku. Ustawienie `type` albo użycie `.mjs` nadal czyni wybór jasnym i usuwa ostrzeżenie.

1. `.mjs` `.cjs`
2. `package.json` `type`
3. Wykrywanie składni, gdy nie ma pola `type`

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

## Co zapisuje LogBrew

SDK zapisało każdy błąd parsowania jako 1 problem o nazwie `Browser error: SyntaxError`, z kluczem grupowania `browser.error:SyntaxError`. Problem miał ścieżkę pliku i wiersz, zero ramek stosu i komunikat `redacted`, bo SDK nie wysyła komunikatów błędów.

Błędy import i export z obu przeglądarek trafiły do tego samego problemu, bo klucz zawiera tylko typ błędu. Pole `sourcePath` mówi, który plik poprawić. Skrypt z innego źródła stał się osobnym problemem, `Browser error: Error`, z wierszem 0 i bez ścieżki pliku.

Z SDK w skrypcie modułu LogBrew nie zapisał nic dla tej samej strony. Wczytaj SDK w klasycznym skrypcie przed swoim kodem, jak w ostatnim kroku.

- `Browser error: SyntaxError`
  - `mechanism`: `browser.error`
  - `handled`: `false`
  - `sourcePath`: `/app.js`
  - `lineNumber`: `1`
  - Ramki stosu: 0
  - Klucz grupowania: `browser.error:SyntaxError`
  - Komunikat: `redacted`
- `Browser error: Error`
  - `lineNumber`: `0`
  - Klucz grupowania: `browser.error:Error`

## Najczęściej zadawane pytania

### Co znaczy Cannot use import statement outside a module?

Plik ma deklarację `import`, ale uruchomił się jako klasyczny skrypt w przeglądarce albo jako CommonJS w Node.js. Wczytaj go jako moduł, by to naprawić.

### Jak to naprawić w przeglądarce?

Dodaj `type="module"` do tagu script, który wczytuje plik. W naszym teście ten sam `app.js` zadziałał potem w Chrome 157 i Safari 27.2.

### Jak to naprawić w Node.js?

Ustaw `"type": "module"` w `package.json` albo zmień nazwę pliku na `.mjs`. Od v22.7.0 Node.js wykrywa też składnię modułu w pakiecie bez pola `type` i wypisuje ostrzeżenie.

### Dlaczego Safari pokazuje inny błąd?

Safari 27.2 zgłosił `Unexpected token '{'. import call expects one or two arguments.` dla tego samego pliku. To ten sam problem z tym samym rozwiązaniem.

### Co znaczy Unexpected token export?

Klasyczny skrypt nie może też używać `export`. Chrome zgłosił `Unexpected token 'export'`, a Safari `Unexpected keyword 'export'`. Wczytaj ten plik także jako moduł.

## Zobacz każdy skrypt, którego nie da się sparsować

SDK LogBrew dla przeglądarki zapisuje każdy błąd parsowania z plikiem i wierszem, pogrupowany według typu błędu. Zacznij od hojnego darmowego planu, bez karty.

[Zacznij za darmo](https://logbrew.co/pl)

## Źródła

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

## Więcej napraw błędów

- [Napraw błąd Script error, który ukrywa komunikat, plik i wiersz](https://logbrew.co/pl/errors/script-error)
- [Napraw błąd Failed to fetch i odróżnij jego 3 przyczyny](https://logbrew.co/pl/errors/failed-to-fetch)
- [Napraw java.lang.NullPointerException w Kotlinie i Androidzie po jego komunikacie](https://logbrew.co/pl/errors/nullpointerexception)
- [Napraw Minified React error #418 i #185 z pełnego komunikatu i własnego wiersza kodu](https://logbrew.co/pl/errors/minified-react-error)
- [Napraw AxiosError Network Error i ustal, którą z 3 przyczyn masz](https://logbrew.co/pl/errors/axios-network-error)
- [Napraw błąd HTTP 499 i ustal, kto przestał czekać](https://logbrew.co/pl/errors/http-499)
- [Błędy, które odtworzyliśmy, i jak naprawić każdy z nich](https://logbrew.co/pl/errors)
