---
title: "Atasi Cannot use import statement outside a module di browser dan di Node.js"
description: "SyntaxError: Cannot use import statement outside a module berarti file berjalan sebagai skrip klasik atau sebagai CommonJS. Muat file itu sebagai modul, dan import yang sama pun berjalan."
canonical: "https://logbrew.co/id/errors/cannot-use-import-statement-outside-a-module"
last_updated: "2026-11-21"
---

# Atasi Cannot use import statement outside a module di browser dan di Node.js

`SyntaxError: Cannot use import statement outside a module` berarti file berjalan sebagai skrip klasik atau sebagai CommonJS. Muat file itu sebagai modul, dan `import` yang sama pun berjalan.

Diuji pada 21 November 2026 dengan Chrome 157, Safari 27.2, Node.js 22.18.0, dan @logbrew/browser 0.1.22

Oleh [Furkan Erday](https://github.com/furkanerday). Furkan Erday adalah pendiri LogBrew. Setiap hari ia membangun LogBrew dengan Claude Code dan Codex.

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

## Apa yang dilakukan 5 tag script pada 1 `import`

| Cara halaman memuatnya | Kode berjalan | Masalah di LogBrew |
| --- | --- | --- |
| `<script src>` tanpa tipe | Tidak | `SyntaxError` |
| `<script>` inline | Tidak | `SyntaxError` |
| `<script src>` dari origin lain | Tidak | `Error`, baris 0 |
| SDK di skrip `type="module"` | Tidak | Tidak |
| `<script type="module">` | Ya | Tidak ada error |

Chrome 157 dan Safari 27.2 memberi hasil yang sama untuk tiap tag.

## Cari tempat file berjalan sebagai skrip klasik

### Lihat tag script yang memuat file

Tag itu tidak punya atribut `type`, jadi browser membaca `app.js` sebagai skrip klasik, dan skrip klasik tidak bisa memakai `import`. Chrome 157 berhenti di baris 1, kolom 1, sebelum satu baris pun dari file itu berjalan. Skrip inline memberi pesan yang sama.

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

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

pour("IPA");
```

Output

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

### Safari memberi pesan lain untuk file yang sama

Safari 27.2 membaca `app.js` yang sama dan melempar `SyntaxError: Unexpected token '{'. import call expects one or two arguments.` Pesan itu membahas panggilan `import()` dan tidak menyebut modul. Penyebab dan solusinya sama.

Output

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

### Export di skrip klasik juga gagal

File yang hanya melakukan ekspor, dimuat dengan tag klasik, berhenti di `export` pertamanya. Chrome menampilkan `Unexpected token 'export'` dan Safari `Unexpected keyword 'export'`. Keduanya berarti halaman memuat modul sebagai skrip klasik.

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

Output

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

### Di Node.js, lihat field type di package.json

Node.js 22.18.0 melempar pesan yang sama saat `package.json` berisi `"type": "commonjs"`. Stack-nya lewat `wrapSafe` di loader CommonJS. Tanpa field `type`, Node.js menjalankan file sebagai modul dan mencetak peringatan, bukan error.

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

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

Output

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

## Muat file sebagai modul

### Tambahkan tipe module ke tag script

Dengan `type="module"` di tag yang sama, `app.js` dan `import`-nya berjalan di Chrome 157 dan Safari 27.2. Browser lalu memuat `tap.js` sendiri. Kalau ada tag klasik yang juga memuat `tap.js`, hapus tag itu, karena tag itu tetap berhenti di `export`.

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

### Atur tipe module di package.json

Isi `"type": "module"` di `package.json`, atau ganti nama file menjadi `.mjs`. Keduanya menjalankan file kami tanpa peringatan. Node.js membaca file `.mjs` sebagai modul dan file `.cjs` sebagai CommonJS, apa pun isi field `type`.

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

// node app.js
```

Output

```text
poured IPA
```

### Muat SDK LogBrew lebih dulu di skrip klasik

Error parsing terjadi sebelum satu baris pun dari file itu berjalan, jadi listener error harus sudah ada di halaman. Browser baru menjalankan skrip modul setelah selesai membaca halaman, jadi skrip modul datang terlambat. Dengan SDK di skrip klasik di dalam `<head>`, LogBrew merekam error-nya. Dengan SDK di skrip `type="module"`, tidak ada yang terekam.

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

## Hasil pengujian kami

Kami menyajikan 1 halaman di `http://127.0.0.1:28180` dan membukanya di Chrome 157 dan Safari 27.2, dengan `@logbrew/browser` 0.1.22 dimuat paling awal. Kami memuat kode yang sama dengan 5 cara dan membaca `error.message` dari event `error`.

Chrome menyebut penyebabnya, Safari tidak. Kedua browser menjalankan file dengan `type="module"`. Skrip dari origin lain hanya memberi `Script error.`, tanpa nama file dan di baris 0, karena browser menyembunyikan detail skrip dari origin lain.

Node.js 22.18.0 memberi error hanya dengan `"type": "commonjs"`. Tanpa field `type`, Node.js menjalankan file dan mencetak peringatan di bawah.

Output

```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>` tanpa tipe | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `<script>` inline tanpa tipe | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `tap.js` dengan `export`, tag klasik | `Unexpected token 'export'` | `Unexpected keyword 'export'` |
| `<script src>` dari origin lain | `Script error.` | `Script error.` |
| `<script type="module">` | Berjalan | Berjalan |

## Kenapa skrip klasik tidak bisa memakai import

Halaman MDN untuk error ini menyebut bahwa deklarasi `import` hanya boleh ada di tingkat teratas sebuah modul, dan penyebab umumnya adalah file yang tidak berjalan sebagai modul. Browser membaca file sebagai modul hanya jika tag-nya punya `type="module"`. Tanpa tipe, browser mem-parsing file sebagai skrip klasik dan berhenti di `import` pertama.

Skrip klasik boleh memakai panggilan fungsi `import()`. Pesan Safari membahas panggilan itu, jadi yang dilaporkan adalah argumen yang kurang, bukan modul yang kurang.

Node.js memutuskan untuk tiap file. Pertama ia melihat ekstensi file, lalu field `type` dari `package.json` terdekat. Menurut dokumentasi Node.js, sejak v22.7.0 dan v20.19.0, file tanpa field `type` yang tidak bisa di-parsing sebagai CommonJS berjalan sebagai modul.

nodejs/node#39353 meminta pada 2021 agar Node.js memilih berdasarkan entry point, bukan berdasarkan `package.json`. Permintaan itu ditutup pada 2022. Mengatur `type` atau memakai `.mjs` tetap membuat pilihannya jelas, dan menghilangkan peringatannya.

1. `.mjs` `.cjs`
2. `package.json` `type`
3. Deteksi sintaks, saat tidak ada field `type`

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

## Apa yang direkam LogBrew

SDK merekam setiap error parsing sebagai 1 masalah bernama `Browser error: SyntaxError`, dengan kunci pengelompokan `browser.error:SyntaxError`. Masalah itu punya path file dan baris, tanpa frame stack, dan pesannya `redacted`, karena SDK tidak mengirim pesan error.

Error import dan export dari kedua browser masuk ke masalah yang sama, karena kuncinya hanya berisi tipe error. Field `sourcePath` memberi tahu file mana yang perlu diperbaiki. Skrip dari origin lain menjadi masalah terpisah, `Browser error: Error`, di baris 0 dan tanpa path file.

Dengan SDK di skrip modul, LogBrew tidak merekam apa pun untuk halaman yang sama. Muat SDK di skrip klasik sebelum kode kamu, seperti di langkah terakhir.

- `Browser error: SyntaxError`
  - `mechanism`: `browser.error`
  - `handled`: `false`
  - `sourcePath`: `/app.js`
  - `lineNumber`: `1`
  - Frame stack: 0
  - Kunci pengelompokan: `browser.error:SyntaxError`
  - Pesan: `redacted`
- `Browser error: Error`
  - `lineNumber`: `0`
  - Kunci pengelompokan: `browser.error:Error`

## Pertanyaan yang sering diajukan

### Apa arti Cannot use import statement outside a module?

File itu punya deklarasi `import`, tetapi berjalan sebagai skrip klasik di browser atau sebagai CommonJS di Node.js. Muat file sebagai modul untuk memperbaikinya.

### Bagaimana cara memperbaikinya di browser?

Tambahkan `type="module"` ke tag script yang memuat file. Dalam pengujian kami, `app.js` yang sama lalu berjalan di Chrome 157 dan Safari 27.2.

### Bagaimana cara memperbaikinya di Node.js?

Isi `"type": "module"` di `package.json`, atau ganti nama file menjadi `.mjs`. Sejak v22.7.0, Node.js juga mendeteksi sintaks modul di paket tanpa field `type` dan mencetak peringatan.

### Kenapa Safari menampilkan error lain?

Safari 27.2 melaporkan `Unexpected token '{'. import call expects one or two arguments.` untuk file yang sama. Masalahnya sama, solusinya juga sama.

### Apa arti Unexpected token export?

Skrip klasik juga tidak bisa memakai `export`. Chrome menampilkan `Unexpected token 'export'` dan Safari `Unexpected keyword 'export'`. Muat juga file itu sebagai modul.

## Lihat setiap skrip yang gagal di-parsing

SDK browser LogBrew merekam setiap error parsing dengan file dan barisnya, dikelompokkan menurut tipe error. Mulai dengan paket gratis yang lega, tanpa perlu kartu.

[Mulai gratis](https://logbrew.co/id)

## Sumber

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

## Solusi error lainnya

- [Atasi script error yang menyembunyikan pesan, file, dan barisnya](https://logbrew.co/id/errors/script-error)
- [Atasi error Failed to fetch dan bedakan 3 penyebabnya](https://logbrew.co/id/errors/failed-to-fetch)
- [Atasi java.lang.NullPointerException di Kotlin dan Android dari pesannya](https://logbrew.co/id/errors/nullpointerexception)
- [Atasi Minified React error #418 dan #185 dari pesan lengkap dan baris kode kamu](https://logbrew.co/id/errors/minified-react-error)
- [Atasi AxiosError Network Error dan cari tahu mana dari 3 penyebabnya](https://logbrew.co/id/errors/axios-network-error)
- [Atasi error HTTP 499 dan cari tahu siapa yang berhenti menunggu](https://logbrew.co/id/errors/http-499)
- [Error yang kami reproduksi, dan cara mengatasinya](https://logbrew.co/id/errors)
