---
title: "Cannot use import statement outside a module hatasını tarayıcıda ve Node.js'te çöz"
description: "SyntaxError: Cannot use import statement outside a module, dosyanın klasik betik ya da CommonJS olarak çalıştığı anlamına gelir. Dosyayı modül olarak yükle, aynı import çalışır."
canonical: "https://logbrew.co/tr/errors/cannot-use-import-statement-outside-a-module"
last_updated: "2026-11-21"
---

# Cannot use import statement outside a module hatasını tarayıcıda ve Node.js'te çöz

`SyntaxError: Cannot use import statement outside a module`, dosyanın klasik betik ya da CommonJS olarak çalıştığı anlamına gelir. Dosyayı modül olarak yükle, aynı `import` çalışır.

21 Kasım 2026 tarihinde Chrome 157, Safari 27.2, Node.js 22.18.0 ve @logbrew/browser 0.1.22 ile test edildi

[Furkan Erday](https://github.com/furkanerday) tarafından. Furkan Erday, LogBrew'un kurucusu. LogBrew'u her gün Claude Code ve Codex ile geliştiriyor.

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

## 5 script etiketi 1 `import` ile ne yaptı

| Sayfa onu nasıl yükledi | Kod çalıştı | LogBrew'da sorun |
| --- | --- | --- |
| Türü olmayan `<script src>` | Hayır | `SyntaxError` |
| Satır içi `<script>` | Hayır | `SyntaxError` |
| Başka kaynaktan `<script src>` | Hayır | `Error`, satır 0 |
| `type="module"` betiğinde SDK | Hayır | Hayır |
| `<script type="module">` | Evet | Hata yok |

Chrome 157 ve Safari 27.2 her etikette aynı sonucu verdi.

## Dosyanın nerede klasik betik olarak çalıştığını bul

### Dosyayı yükleyen script etiketine bak

Etiketin `type` özniteliği yok, bu yüzden tarayıcı `app.js` dosyasını klasik betik olarak okur ve klasik betik `import` kullanamaz. Chrome 157, dosyanın tek satırı bile çalışmadan satır 1, sütun 1'de durdu. Satır içi bir betik de aynı mesajı verdi.

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

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

pour("IPA");
```

Çıktı

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

### Safari aynı dosya için başka bir mesaj verir

Safari 27.2 aynı `app.js` dosyasını okudu ve `SyntaxError: Unexpected token '{'. import call expects one or two arguments.` fırlattı. Mesaj bir `import()` çağrısından söz eder ve modülden hiç bahsetmez. Neden de çözüm de aynıdır.

Çıktı

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

### Klasik betikteki export da hata verir

Yalnızca dışa aktarma yapan ve klasik bir etiketle yüklenen dosya ilk `export` satırında durur. Chrome `Unexpected token 'export'`, Safari `Unexpected keyword 'export'` dedi. İkisi de sayfanın bir modülü klasik betik olarak yüklediğini gösterir.

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

Çıktı

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

### Node.js'te package.json dosyasının type alanına bak

Node.js 22.18.0, `package.json` içinde `"type": "commonjs"` varken aynı mesajı fırlattı. Stack, CommonJS yükleyicisindeki `wrapSafe` üzerinden geçer. `type` alanı yokken Node.js dosyayı modül olarak çalıştırdı ve hata yerine bir uyarı yazdırdı.

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

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

Çıktı

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

## Dosyayı modül olarak yükle

### Script etiketine modül türünü ekle

Aynı etikette `type="module"` olunca `app.js` ve içindeki `import`, Chrome 157 ve Safari 27.2'de çalıştı. Tarayıcı bu durumda `tap.js` dosyasını kendisi yükler. Klasik bir etiket de `tap.js` yüklüyorsa o etiketi kaldır, çünkü o hâlâ `export` satırında durur.

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

### package.json içinde modül türünü ayarla

`package.json` içine `"type": "module"` yaz ya da dosyanın adını `.mjs` olarak değiştir. İkisi de dosyamızı uyarısız çalıştırdı. Node.js, `type` alanı ne derse desin, `.mjs` dosyasını modül, `.cjs` dosyasını CommonJS olarak okur.

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

// node app.js
```

Çıktı

```text
poured IPA
```

### LogBrew SDK'sını önce klasik bir betikte yükle

Ayrıştırma hatası, o dosyanın tek satırı çalışmadan oluşur, bu yüzden hata dinleyicisinin sayfada önceden olması gerekir. Tarayıcı bir modül betiğini ancak sayfayı okuduktan sonra çalıştırır, yani modül betiği geç kalır. SDK `<head>` içindeki klasik bir betikteyken LogBrew hatayı kaydetti. SDK `type="module"` betiğindeyken hiçbir şey kaydetmedi.

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

## Test ederken gördüklerimiz

1 sayfayı `http://127.0.0.1:28180` adresinde sunduk ve Chrome 157 ile Safari 27.2'de açtık, `@logbrew/browser` 0.1.22 ilk sırada yüklendi. Aynı kodu 5 farklı şekilde yükledik ve `error` olayından `error.message` değerini okuduk.

Chrome nedeni söyledi, Safari söylemedi. İki tarayıcı da dosyayı `type="module"` ile çalıştırdı. Başka bir kaynaktan gelen betik yalnızca `Script error.` verdi, dosya adı yoktu ve satır 0'dı, çünkü tarayıcı başka kaynaktan gelen betiğin ayrıntılarını gizler.

Node.js 22.18.0 hatayı yalnızca `"type": "commonjs"` ile verdi. `type` alanı yokken dosyayı çalıştırdı ve aşağıdaki uyarıyı yazdırdı.

Çıktı

```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 |
| --- | --- | --- |
| Türü olmayan `<script src>` | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| Türü olmayan satır içi `<script>` | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `tap.js`, `export` içerir, klasik etiket | `Unexpected token 'export'` | `Unexpected keyword 'export'` |
| Başka kaynaktan `<script src>` | `Script error.` | `Script error.` |
| `<script type="module">` | Çalıştı | Çalıştı |

## Klasik betik neden import kullanamaz

MDN'nin bu hata sayfası, `import` bildiriminin yalnızca bir modülün en üst düzeyinde kullanılabildiğini ve olağan nedenin modül olarak çalışmayan bir dosya olduğunu söyler. Tarayıcı bir dosyayı ancak etiketinde `type="module"` varsa modül olarak okur. Tür yoksa dosyayı klasik betik olarak ayrıştırır ve ilk `import` satırında durur.

Klasik betik `import()` işlev çağrısını kullanabilir. Safari'nin mesajı bu çağrıdan söz eder, bu yüzden eksik modül değil eksik argüman bildirir.

Node.js her dosya için ayrı karar verir. Önce dosya uzantısına, sonra en yakın `package.json` dosyasının `type` alanına bakar. Node.js dokümantasyonuna göre v22.7.0 ve v20.19.0 sürümünden beri, `type` alanı olmayan ve CommonJS olarak ayrıştırılamayan bir dosya modül olarak çalışır.

nodejs/node#39353, 2021'de Node.js'in seçimi `package.json` yerine giriş noktasına göre yapmasını istedi. 2022'de kapatıldı. `type` ayarlamak ya da `.mjs` kullanmak seçimi yine netleştirir ve uyarıyı kaldırır.

1. `.mjs` `.cjs`
2. `package.json` `type`
3. `type` alanı yokken sözdizimi algılama

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

## LogBrew ne kaydeder

SDK her ayrıştırma hatasını `browser.error:SyntaxError` gruplama anahtarıyla `Browser error: SyntaxError` adlı 1 sorun olarak kaydetti. Sorunda dosya yolu ve satır vardı, stack frame yoktu ve mesaj `redacted` idi, çünkü SDK hata mesajlarını göndermez.

İki tarayıcıdaki import ve export hataları aynı soruna düştü, çünkü anahtar yalnızca hata türünü içerir. Hangi dosyayı düzelteceğini `sourcePath` söyler. Başka kaynaktan gelen betik ayrı bir sorun oldu, `Browser error: Error`, satır 0 ve dosya yolu olmadan.

SDK bir modül betiğindeyken LogBrew aynı sayfa için hiçbir şey kaydetmedi. Son adımdaki gibi SDK'yı kodundan önce klasik bir betikte yükle.

- `Browser error: SyntaxError`
  - `mechanism`: `browser.error`
  - `handled`: `false`
  - `sourcePath`: `/app.js`
  - `lineNumber`: `1`
  - Stack frame'leri: 0
  - Gruplama anahtarı: `browser.error:SyntaxError`
  - Mesaj: `redacted`
- `Browser error: Error`
  - `lineNumber`: `0`
  - Gruplama anahtarı: `browser.error:Error`

## Sık sorulan sorular

### Cannot use import statement outside a module ne demek?

Dosyada bir `import` bildirimi var, ama tarayıcıda klasik betik ya da Node.js'te CommonJS olarak çalıştı. Çözmek için dosyayı modül olarak yükle.

### Tarayıcıda nasıl çözerim?

Dosyayı yükleyen script etiketine `type="module"` ekle. Testimizde aynı `app.js` bundan sonra Chrome 157 ve Safari 27.2'de çalıştı.

### Node.js'te nasıl çözerim?

`package.json` içine `"type": "module"` yaz ya da dosyanın adını `.mjs` yap. Node.js v22.7.0'dan beri `type` alanı olmayan bir pakette de modül sözdizimini algılar ve bir uyarı yazdırır.

### Safari neden başka bir hata gösteriyor?

Safari 27.2 aynı dosya için `Unexpected token '{'. import call expects one or two arguments.` bildirdi. Sorun aynı, çözüm de aynı.

### Unexpected token export ne demek?

Klasik betik `export` de kullanamaz. Chrome `Unexpected token 'export'`, Safari `Unexpected keyword 'export'` dedi. O dosyayı da modül olarak yükle.

## Ayrıştırılamayan her betiği gör

LogBrew tarayıcı SDK'sı her ayrıştırma hatasını dosyası ve satırıyla, hata türüne göre gruplayarak kaydeder. Cömert ücretsiz planla başla, kart gerekmez.

[Ücretsiz başla](https://logbrew.co/tr)

## Kaynaklar

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

## Diğer hata çözümleri

- [Mesajını, dosyasını ve satırını gizleyen script error hatasını çöz](https://logbrew.co/tr/errors/script-error)
- [Failed to fetch hatasını çöz ve 3 nedenini birbirinden ayır](https://logbrew.co/tr/errors/failed-to-fetch)
- [Kotlin ve Android'de java.lang.NullPointerException'ı mesajından çöz](https://logbrew.co/tr/errors/nullpointerexception)
- [Minified React error #418 ve #185'i tam mesajdan ve kaynak satırından düzelt](https://logbrew.co/tr/errors/minified-react-error)
- [AxiosError Network Error hatasını çöz ve 3 nedeninden hangisi olduğunu bul](https://logbrew.co/tr/errors/axios-network-error)
- [HTTP 499 hatasını çöz ve beklemeyi kimin bıraktığını bul](https://logbrew.co/tr/errors/http-499)
- [Yeniden ürettiğimiz hatalar ve her birinin çözümü](https://logbrew.co/tr/errors)
