SyntaxError: Cannot use import statement outside a module
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
// raport.cjs
import fs from "fs";
module.exports = fs.readdirSync(".");// 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"
// package.json
{ "type": "commonjs" }
// index.js
import express from "express";// 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
import { readFileSync } from "fs";const { readFileSync } = require("fs");Dacă restul proiectului folosește require, transformă importurile în require și exporturile în module.exports.
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.
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)})`);
}vanzari-iunie (.csv) clienti (.json) poza (.png)
Indiciu
import path from "path"; se scrie în CommonJS const path = require("path");.
Reparația
const path = require("path");
const fisiere = ["vanzari-iunie.csv", "clienti.json", "poza.png"];
for (const f of fisiere) {
console.log(`${path.parse(f).name} (${path.extname(f)})`);
}De ce merge
Câmpul "type": "commonjs" din package.json îi spune lui Node să citească toate fișierele .js ca CommonJS, unde instrucțiunea import nu există. Cu require("path") fișierul devine CommonJS valid și primești același obiect path. Varianta inversă ar fi fost să schimbi "type" în "module" și să rămâi pe import, dar atunci toate celelalte fișiere ale proiectului trebuie să folosească tot import.
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 moduleWarning: 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.jsoncu"type". - Folosește
.mjsși.cjsdoar când ai nevoie de excepții de la regula proiectului. - Nu amesteca
importșirequireîn același fișier. - În browser, scripturile cu
importau 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
ReferenceError: require is not defined in ES module scope, you can use import instead Fișierul este modul ES (are import/export, extensia .mjs sau "type": "module" în package.json), iar în modulele ES require nu există. Înlocuiește require cu import: const fs = require("fs") devine import fs from "fs". Error [ERR_REQUIRE_ESM]: require() of ES Module /app/node_modules/chalk/source/index.js from /app/index.js not supported. Încerci să încarci cu require un modul care e scris ca modul ES (multe pachete noi, ca chalk 5 sau node-fetch 3, sunt doar ESM). Folosește import în loc de require, un import() dinamic, sau o versiune mai veche a pachetului care are CommonJS. Î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.
