---
title: "Corriger Cannot use import statement outside a module dans le navigateur et dans Node.js"
description: "SyntaxError: Cannot use import statement outside a module signifie que le fichier a tourné comme script classique ou comme CommonJS. Chargez-le comme module et le même import s’exécute."
canonical: "https://logbrew.co/fr/errors/cannot-use-import-statement-outside-a-module"
last_updated: "2026-11-21"
---

# Corriger Cannot use import statement outside a module dans le navigateur et dans Node.js

`SyntaxError: Cannot use import statement outside a module` signifie que le fichier a tourné comme script classique ou comme CommonJS. Chargez-le comme module et le même `import` s’exécute.

Testé le 21 novembre 2026 avec Chrome 157, Safari 27.2, Node.js 22.18.0 et @logbrew/browser 0.1.22

Par [Furkan Erday](https://github.com/furkanerday). Furkan Erday est le fondateur de LogBrew. Il développe LogBrew avec Claude Code et Codex tous les jours.

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

## Ce que 5 balises script ont fait d’1 `import`

| Comment la page l’a chargé | Code exécuté | Problème dans LogBrew |
| --- | --- | --- |
| `<script src>` sans type | Non | `SyntaxError` |
| `<script>` inline | Non | `SyntaxError` |
| `<script src>` d’une autre origine | Non | `Error`, ligne 0 |
| SDK dans un script `type="module"` | Non | Non |
| `<script type="module">` | Oui | Aucune erreur |

Chrome 157 et Safari 27.2 ont donné le même résultat pour chaque balise.

## Trouver où le fichier a tourné comme script classique

### Regardez la balise script qui charge le fichier

La balise n’a pas d’attribut `type`, donc le navigateur lit `app.js` comme un script classique, et un script classique ne peut pas utiliser `import`. Chrome 157 s’est arrêté à la ligne 1, colonne 1, avant d’exécuter la moindre ligne du fichier. Un script inline a donné le même message.

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

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

pour("IPA");
```

Sortie

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

### Safari donne un autre message pour le même fichier

Safari 27.2 a lu le même `app.js` et a levé `SyntaxError: Unexpected token '{'. import call expects one or two arguments.` Le message parle d’un appel `import()` et ne mentionne pas de module. La cause et le correctif sont les mêmes.

Sortie

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

### Un export dans un script classique échoue aussi

Un fichier qui ne fait qu’exporter, chargé par une balise classique, s’arrête à son premier `export`. Chrome a affiché `Unexpected token 'export'` et Safari `Unexpected keyword 'export'`. Dans les 2 cas, la page a chargé un module comme script classique.

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

Sortie

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

### Dans Node.js, lisez le champ type du package.json

Node.js 22.18.0 a levé le même message quand le `package.json` contenait `"type": "commonjs"`. La pile passe par `wrapSafe` dans le chargeur CommonJS. Sans champ `type`, Node.js a exécuté le fichier comme module et a affiché un avertissement à la place.

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

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

Sortie

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

## Charger le fichier comme module

### Ajoutez le type module à la balise script

Avec `type="module"` sur la même balise, `app.js` et son `import` se sont exécutés dans Chrome 157 et Safari 27.2. Le navigateur charge alors `tap.js` lui-même. Si une balise classique charge aussi `tap.js`, supprimez-la, car elle s’arrête toujours sur `export`.

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

### Définissez le type module dans le package.json

Mettez `"type": "module"` dans le `package.json`, ou renommez le fichier en `.mjs`. Les 2 ont exécuté notre fichier sans avertissement. Node.js lit un fichier `.mjs` comme module et un fichier `.cjs` comme CommonJS, quel que soit le champ `type`.

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

// node app.js
```

Sortie

```text
poured IPA
```

### Chargez d’abord le SDK LogBrew dans un script classique

Une erreur d’analyse survient avant l’exécution de toute ligne du fichier, donc l’écouteur d’erreurs doit déjà être sur la page. Le navigateur n’exécute un script module qu’après avoir lu la page, donc il arrive trop tard. Avec le SDK dans un script classique dans `<head>`, LogBrew a enregistré l’erreur. Avec le SDK dans un script `type="module"`, rien.

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

## Ce que nous avons vu en testant

Nous avons servi 1 page sur `http://127.0.0.1:28180` et l’avons ouverte dans Chrome 157 et Safari 27.2, avec `@logbrew/browser` 0.1.22 chargé en premier. Nous avons chargé le même code de 5 façons et lu `error.message` dans l’événement `error`.

Chrome a nommé la cause, Safari non. Les 2 navigateurs ont exécuté le fichier avec `type="module"`. Un script d’une autre origine n’a donné que `Script error.`, sans nom de fichier et à la ligne 0, car le navigateur masque les détails d’un script d’une autre origine.

Node.js 22.18.0 n’a donné l’erreur qu’avec `"type": "commonjs"`. Sans champ `type`, il a exécuté le fichier et affiché l’avertissement ci-dessous.

Sortie

```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>` sans type | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `<script>` inline sans type | `Cannot use import statement outside a module` | `Unexpected token '{'. import call expects one or two arguments.` |
| `tap.js` avec un `export`, balise classique | `Unexpected token 'export'` | `Unexpected keyword 'export'` |
| `<script src>` d’une autre origine | `Script error.` | `Script error.` |
| `<script type="module">` | Exécuté | Exécuté |

## Pourquoi un script classique ne peut pas utiliser import

La page MDN de cette erreur indique qu’une déclaration `import` n’est permise qu’au niveau supérieur d’un module, et que la cause habituelle est un fichier qui ne tourne pas comme module. Un navigateur ne lit un fichier comme module que si sa balise a `type="module"`. Sans type, il l’analyse comme script classique et s’arrête au premier `import`.

Un script classique peut utiliser l’appel de fonction `import()`. Le message de Safari parle de cet appel, d’où une erreur d’argument manquant et non de module manquant.

Node.js décide fichier par fichier. Il lit d’abord l’extension, puis le champ `type` du `package.json` le plus proche. D’après la documentation Node.js, depuis v22.7.0 et v20.19.0, un fichier sans champ `type` qui ne s’analyse pas comme CommonJS tourne comme module.

nodejs/node#39353 demandait en 2021 que Node.js choisisse d’après le point d’entrée et non d’après le `package.json`. Le ticket a été fermé en 2022. Définir `type` ou utiliser `.mjs` rend toujours le choix clair, et supprime l’avertissement.

1. `.mjs` `.cjs`
2. `package.json` `type`
3. Détection de la syntaxe, sans champ `type`

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

## Ce que LogBrew enregistre

Le SDK a enregistré chaque erreur d’analyse dans 1 problème nommé `Browser error: SyntaxError`, avec la clé de regroupement `browser.error:SyntaxError`. Le problème avait le chemin du fichier et la ligne, aucune frame de pile, et le message `redacted`, car le SDK n’envoie pas les messages d’erreur.

Les erreurs import et export des 2 navigateurs sont allées dans ce même problème, car la clé ne contient que le type d’erreur. Le champ `sourcePath` indique quel fichier corriger. Le script d’une autre origine a donné un problème à part, `Browser error: Error`, à la ligne 0 et sans chemin de fichier.

Avec le SDK dans un script module, LogBrew n’a rien enregistré pour la même page. Chargez le SDK dans un script classique avant votre code, comme à la dernière étape.

- `Browser error: SyntaxError`
  - `mechanism`: `browser.error`
  - `handled`: `false`
  - `sourcePath`: `/app.js`
  - `lineNumber`: `1`
  - Frames de stack trace: 0
  - Clé de regroupement: `browser.error:SyntaxError`
  - Message: `redacted`
- `Browser error: Error`
  - `lineNumber`: `0`
  - Clé de regroupement: `browser.error:Error`

## Questions fréquentes

### Que signifie Cannot use import statement outside a module ?

Le fichier contient une déclaration `import`, mais il a tourné comme script classique dans le navigateur ou comme CommonJS dans Node.js. Chargez-le comme module pour corriger l’erreur.

### Comment corriger l’erreur dans le navigateur ?

Ajoutez `type="module"` à la balise script qui charge le fichier. Dans notre test, le même `app.js` s’est ensuite exécuté dans Chrome 157 et Safari 27.2.

### Comment corriger l’erreur dans Node.js ?

Mettez `"type": "module"` dans le `package.json`, ou renommez le fichier en `.mjs`. Depuis v22.7.0, Node.js détecte aussi la syntaxe module dans un paquet sans champ `type` et affiche un avertissement.

### Pourquoi Safari affiche-t-il une autre erreur ?

Safari 27.2 a affiché `Unexpected token '{'. import call expects one or two arguments.` pour le même fichier. C’est le même problème, avec le même correctif.

### Pourquoi export échoue-t-il aussi dans un script classique ?

Un script classique ne peut pas non plus utiliser `export`. Chrome a affiché `Unexpected token 'export'` et Safari `Unexpected keyword 'export'`. Chargez aussi ce fichier comme module.

## Voyez chaque script qui ne s’analyse pas

Le SDK navigateur de LogBrew enregistre chaque erreur d’analyse avec son fichier et sa ligne, regroupée par type d’erreur. Commencez avec le généreux forfait Free, sans carte bancaire.

[Commencer gratuitement](https://logbrew.co/fr)

## Sources

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

## D’autres correctifs d’erreurs

- [Corriger l’erreur de script qui cache son message, son fichier et sa ligne](https://logbrew.co/fr/errors/script-error)
- [Corriger l’erreur Failed to fetch et distinguer ses 3 causes](https://logbrew.co/fr/errors/failed-to-fetch)
- [Corriger java.lang.NullPointerException en Kotlin et Android d’après son message](https://logbrew.co/fr/errors/nullpointerexception)
- [Corriger l’erreur Minified React #418 et #185 avec le message complet et votre ligne de code](https://logbrew.co/fr/errors/minified-react-error)
- [Corriger l’erreur réseau AxiosError et trouver laquelle de ses 3 causes vous avez](https://logbrew.co/fr/errors/axios-network-error)
- [Corriger l’erreur HTTP 499 et trouver qui a cessé d’attendre](https://logbrew.co/fr/errors/http-499)
- [Les erreurs que nous avons reproduites, et comment corriger chacune](https://logbrew.co/fr/errors)
