...
Eroare Node.js · Module ES: import, export și "type": "module"

SyntaxError: Cannot use import statement outside a module

Pe scurt

Node încarcă fișierul ca modul CommonJS, unde import nu e permis. Ori treci pe require, ori spui că fișierul e modul ES: extensia .mjs sau "type": "module" în package.json. Fișierele .cjs și proiectele cu "type": "commonjs" acceptă doar require.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Node are două sisteme de module: CommonJS (require, module.exports) și module ES (import, export). Mesajul apare când un fișier tratat ca CommonJS conține import.

Cum decide Node tipul fișierului: .mjs înseamnă modul ES, .cjs înseamnă CommonJS, iar la .js contează câmpul "type" din cel mai apropiat package.json ("module" sau "commonjs"). Versiunile noi de Node detectează singure sintaxa ES într-un .js fără "type", dar dacă package.json are "type": "commonjs" (pe care unele versiuni recente de npm init îl adaugă implicit) sau fișierul e .cjs, primești eroarea.

O mai vezi des în Jest, ts-node sau la scripturi vechi. Linia din mesaj arată primul import din fișierul problemă: uită-te la extensia lui și la package.json.

De ce apare: cauzele frecvente

1import într-un fișier .cjs

Greșit
JavaScript
// raport.cjs
import fs from "fs";
module.exports = fs.readdirSync(".");
Corect
JavaScript
// raport.cjs
const fs = require("fs");
module.exports = fs.readdirSync(".");

Extensia .cjs obligă Node să trateze fișierul ca CommonJS, unde import static nu există.

2package.json are "type": "commonjs"

Greșit
JavaScript
// package.json
{ "type": "commonjs" }
// index.js
import express from "express";
Corect
JavaScript
// package.json
{ "type": "module" }
// index.js
import express from "express";

Câmpul type decide cum sunt citite toate fișierele .js din proiect. Cu "module", import devine valid.

3Vrei să rămâi pe CommonJS

Greșit
JavaScript
import { readFileSync } from "fs";
Corect
JavaScript
const { readFileSync } = require("fs");

Dacă restul proiectului folosește require, transformă importurile în require și exporturile în module.exports.

Repară tu

Repară eroarea, direct în pagină

Proiectul are în package.json setarea "type": "commonjs", deci fișierele .js sunt CommonJS, iar index.js dă SyntaxError: Cannot use import statement outside a module. Rescrie importurile în stil CommonJS, ca programul să afișeze numele și extensia fiecărui fișier.

Codul care dă eroarea
JavaScript
import path from "path";

const fisiere = ["vanzari-iunie.csv", "clienti.json", "poza.png"];
for (const f of fisiere) {
  console.log(`${path.parse(f).name} (${path.extname(f)})`);
}
După reparație, programul afișează
vanzari-iunie (.csv)
clienti (.json)
poza (.png)
Indiciu

import path from "path"; se scrie în CommonJS const path = require("path");.

Alte forme ale mesajului

  • SyntaxError: Cannot use import statement outside a module (at index.js:1:1)
  • Uncaught SyntaxError: Cannot use import statement outside a module
  • Warning: To load an ES module, set "type": "module" in the package.json or use the .mjs extension.

Cum o eviți pe viitor

  • Alege un singur sistem de module pentru proiect și notează-l în package.json cu "type".
  • Folosește .mjs și .cjs doar când ai nevoie de excepții de la regula proiectului.
  • Nu amesteca import și require în același fișier.
  • În browser, scripturile cu import au nevoie de <script type="module">.

Întrebări frecvente

Ce aleg pentru un proiect nou: require sau import?

Pentru proiecte noi, modulele ES (import/export cu "type": "module") sunt standardul. CommonJS rămâne foarte răspândit în proiectele existente, așa că e bine să le recunoști pe amândouă.

Am pus "type": "module" și acum apare require is not defined. De ce?

Acum toate fișierele .js sunt module ES, unde require nu mai există. Transformă și celelalte require în import sau redenumește fișierele CommonJS în .cjs.

De ce în browser apare aceeași eroare?

În pagină, un <script> obișnuit nu e modul. Adaugă type="module" pe tagul <script> ca să poți folosi import.

Erori înrudite

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Node.js de la zero, cu exerciții la fiecare lecție

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.