---
title: "Corrija Cannot use import statement outside a module no navegador e no Node.js"
description: "SyntaxError: Cannot use import statement outside a module significa que o arquivo rodou como script clássico ou como CommonJS. Carregue-o como módulo e o mesmo import roda."
canonical: "https://logbrew.co/pt-BR/errors/cannot-use-import-statement-outside-a-module"
last_updated: "2026-11-21"
---

# Corrija Cannot use import statement outside a module no navegador e no Node.js

`SyntaxError: Cannot use import statement outside a module` significa que o arquivo rodou como script clássico ou como CommonJS. Carregue-o como módulo e o mesmo `import` roda.

Testado em 21 de novembro de 2026 com Chrome 157, Safari 27.2, Node.js 22.18.0 e @logbrew/browser 0.1.22

Por [Furkan Erday](https://github.com/furkanerday). Furkan Erday é o fundador do LogBrew. Ele desenvolve o LogBrew com Claude Code e Codex todos os dias.

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

## O que 5 tags script fizeram com 1 `import`

| Como a página carregou | O código rodou | Problema no LogBrew |
| --- | --- | --- |
| `<script src>` sem tipo | Não | `SyntaxError` |
| `<script>` inline | Não | `SyntaxError` |
| `<script src>` de outra origem | Não | `Error`, linha 0 |
| SDK em um script `type="module"` | Não | Não |
| `<script type="module">` | Sim | Sem erro |

O Chrome 157 e o Safari 27.2 deram o mesmo resultado em cada tag.

## Descubra onde o arquivo rodou como script clássico

### Veja a tag script que carrega o arquivo

A tag não tem o atributo `type`, então o navegador lê `app.js` como script clássico, e um script clássico não pode usar `import`. O Chrome 157 parou na linha 1, coluna 1, antes de rodar qualquer linha do arquivo. Um script inline deu a mesma mensagem.

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

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

pour("IPA");
```

Saída

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

### O Safari dá outra mensagem para o mesmo arquivo

O Safari 27.2 leu o mesmo `app.js` e lançou `SyntaxError: Unexpected token '{'. import call expects one or two arguments.` A mensagem fala de uma chamada `import()` e não menciona módulo. A causa e a correção são as mesmas.

Saída

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

### Um export em script clássico também falha

Um arquivo que só exporta, carregado por uma tag clássica, para no primeiro `export`. O Chrome mostrou `Unexpected token 'export'` e o Safari `Unexpected keyword 'export'`. Os 2 querem dizer que a página carregou um módulo como script clássico.

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

Saída

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

### No Node.js, veja o campo type do package.json

O Node.js 22.18.0 lançou a mesma mensagem quando o `package.json` tinha `"type": "commonjs"`. A stack passa por `wrapSafe` no loader do CommonJS. Sem o campo `type`, o Node.js rodou o arquivo como módulo e mostrou um aviso no lugar do erro.

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

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

Saída

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

## Carregue o arquivo como módulo

### Adicione o tipo module à tag script

Com `type="module"` na mesma tag, `app.js` e seu `import` rodaram no Chrome 157 e no Safari 27.2. O navegador então carrega `tap.js` por você. Se uma tag clássica também carrega `tap.js`, remova essa tag, porque ela continua parando no `export`.

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

### Defina o tipo module no package.json

Coloque `"type": "module"` no `package.json`, ou renomeie o arquivo para `.mjs`. As 2 opções rodaram nosso arquivo sem aviso. O Node.js lê um arquivo `.mjs` como módulo e um `.cjs` como CommonJS, seja qual for o campo `type`.

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

// node app.js
```

Saída

```text
poured IPA
```

### Carregue o SDK do LogBrew primeiro, em um script clássico

Um erro de parse acontece antes de qualquer linha do arquivo rodar, então o listener de erros já precisa estar na página. O navegador só roda um script de módulo depois de ler a página, então ele chega tarde demais. Com o SDK em um script clássico no `<head>`, o LogBrew registrou o erro. Com o SDK em um script `type="module"`, não registrou nada.

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

## O que vimos no teste

Servimos 1 página em `http://127.0.0.1:28180` e a abrimos no Chrome 157 e no Safari 27.2, com o `@logbrew/browser` 0.1.22 carregado primeiro. Carregamos o mesmo código de 5 jeitos e lemos `error.message` no evento `error`.

O Chrome nomeou a causa, o Safari não. Os 2 navegadores rodaram o arquivo com `type="module"`. Um script de outra origem deu só `Script error.`, sem nome de arquivo e com linha 0, porque o navegador esconde os detalhes de um script de outra origem.

O Node.js 22.18.0 deu o erro só com `"type": "commonjs"`. Sem o campo `type`, ele rodou o arquivo e mostrou o aviso abaixo.

Saída

```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>` sem tipo | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `<script>` inline sem tipo | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `tap.js` com `export`, tag clássica | `Unexpected token 'export'` | `Unexpected keyword 'export'` |
| `<script src>` de outra origem | `Script error.` | `Script error.` |
| `<script type="module">` | Rodou | Rodou |

## Por que um script clássico não pode usar import

A página do MDN sobre esse erro diz que uma declaração `import` só pode ficar no nível mais alto de um módulo, e que a causa comum é um arquivo que não roda como módulo. Um navegador só lê um arquivo como módulo quando a tag tem `type="module"`. Sem tipo, ele lê o arquivo como script clássico e para no primeiro `import`.

Um script clássico pode usar a chamada de função `import()`. A mensagem do Safari fala dessa chamada, por isso aponta um argumento que falta e não um módulo.

O Node.js decide arquivo por arquivo. Primeiro vê a extensão, depois o campo `type` do `package.json` mais próximo. Segundo a documentação do Node.js, desde v22.7.0 e v20.19.0 um arquivo sem campo `type` que não passa no parse como CommonJS roda como módulo.

O nodejs/node#39353 pediu em 2021 que o Node.js escolhesse pelo ponto de entrada, e não pelo `package.json`. Foi fechado em 2022. Definir `type` ou usar `.mjs` ainda deixa a escolha clara, e tira o aviso.

1. `.mjs` `.cjs`
2. `package.json` `type`
3. Detecção de sintaxe, quando não há campo `type`

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

## O que o LogBrew registra

O SDK registrou cada erro de parse como 1 problema chamado `Browser error: SyntaxError`, com a chave de agrupamento `browser.error:SyntaxError`. O problema tinha o caminho do arquivo e a linha, nenhum frame de stack e a mensagem `redacted`, porque o SDK não envia mensagens de erro.

Os erros de import e de export dos 2 navegadores foram para esse mesmo problema, porque a chave guarda só o tipo do erro. O `sourcePath` diz qual arquivo corrigir. O script de outra origem virou um problema separado, `Browser error: Error`, com linha 0 e sem caminho de arquivo.

Com o SDK em um script de módulo, o LogBrew não registrou nada na mesma página. Carregue o SDK em um script clássico antes do seu código, como no último passo.

- `Browser error: SyntaxError`
  - `mechanism`: `browser.error`
  - `handled`: `false`
  - `sourcePath`: `/app.js`
  - `lineNumber`: `1`
  - Frames de stack: 0
  - Chave de agrupamento: `browser.error:SyntaxError`
  - Mensagem: `redacted`
- `Browser error: Error`
  - `lineNumber`: `0`
  - Chave de agrupamento: `browser.error:Error`

## Perguntas frequentes

### O que significa Cannot use import statement outside a module?

O arquivo tem uma declaração `import`, mas rodou como script clássico no navegador ou como CommonJS no Node.js. Carregue-o como módulo para corrigir.

### Como corrijo no navegador?

Adicione `type="module"` à tag script que carrega o arquivo. No nosso teste, o mesmo `app.js` rodou depois no Chrome 157 e no Safari 27.2.

### Como corrijo no Node.js?

Coloque `"type": "module"` no `package.json`, ou renomeie o arquivo para `.mjs`. Desde v22.7.0, o Node.js também detecta sintaxe de módulo em um pacote sem campo `type` e mostra um aviso.

### Por que o Safari mostra outro erro?

O Safari 27.2 mostrou `Unexpected token '{'. import call expects one or two arguments.` para o mesmo arquivo. É o mesmo problema, com a mesma correção.

### O que significa Unexpected token export?

Um script clássico também não pode usar `export`. O Chrome mostrou `Unexpected token 'export'` e o Safari `Unexpected keyword 'export'`. Carregue esse arquivo como módulo também.

## Veja cada script que falha no parse

O SDK de navegador do LogBrew registra cada erro de parse com o arquivo e a linha, agrupado por tipo de erro. Comece no plano gratuito generoso, sem cartão.

[Comece grátis](https://logbrew.co/pt-BR)

## Fontes

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

## Mais correções de erros

- [Corrija o erro de script que esconde a mensagem, o arquivo e a linha](https://logbrew.co/pt-BR/errors/script-error)
- [Corrija o erro Failed to fetch e distinga as 3 causas](https://logbrew.co/pt-BR/errors/failed-to-fetch)
- [Corrija java.lang.NullPointerException no Kotlin e no Android a partir da mensagem](https://logbrew.co/pt-BR/errors/nullpointerexception)
- [Corrija Minified React error #418 e #185 com a mensagem completa e a sua linha de código](https://logbrew.co/pt-BR/errors/minified-react-error)
- [Corrija AxiosError Network Error e descubra qual das 3 causas você tem](https://logbrew.co/pt-BR/errors/axios-network-error)
- [Corrija o erro HTTP 499 e descubra quem parou de esperar](https://logbrew.co/pt-BR/errors/http-499)
- [Erros que reproduzimos, e como corrigir cada um](https://logbrew.co/pt-BR/errors)
