SyntaxError: Unexpected token 'export'
Fișierul folosește export (sintaxa modulelor ES), dar Node îl rulează ca CommonJS, de obicei pentru că package.json are "type": "commonjs" sau fișierul are extensia .cjs. Fie scrii exporturile cu module.exports, fie treci proiectul pe module ES cu "type": "module".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Node are două sisteme de module: CommonJS (require și module.exports) și module ES (import și export). Un fișier e citit ca CommonJS dacă are extensia .cjs sau dacă cel mai apropiat package.json conține "type": "commonjs". În CommonJS, cuvântul export nu înseamnă nimic, așa că parserul se oprește la el: Unexpected token 'export'.
De la Node 22, un fișier .js fără "type" în package.json e analizat automat: dacă are sintaxă ES, e rulat ca modul ES. Dar npm init scrie acum implicit "type": "commonjs", iar cu tipul declarat explicit detecția automată nu mai are loc.
Mesajul arată fișierul și linia, cu ^^^^^^ sub export. Dacă fișierul e în node_modules, înseamnă că un pachet ES e încărcat ca CommonJS (de exemplu de Jest sau de un instrument vechi), nu că ai greșit tu în cod.
De ce apare: cauzele frecvente
1Exporturi ES într-un proiect CommonJS
export function formatLei(suma) {
return `${suma.toFixed(2)} lei`;
}function formatLei(suma) {
return `${suma.toFixed(2)} lei`;
}
module.exports = { formatLei };În CommonJS exporturile se pun pe module.exports. Restul proiectului le citește cu require.
2Proiectul ar trebui să fie pe module ES
{
"name": "magazin",
"type": "commonjs"
}{
"name": "magazin",
"type": "module"
}Cu "type": "module", toate fișierele .js sunt module ES și export e valid. Atunci și require trebuie înlocuit peste tot cu import.
3Un pachet ES rulat de un instrument care așteaptă CommonJS
// jest.config.js fără transformare pentru node_modules
// /app/node_modules/pachet/index.js:1
// export default function () {}// folosește versiunea CommonJS a pachetului
// sau configurează instrumentul pentru module ESCând eroarea arată un fișier din node_modules, problema e la cel care îl încarcă: alege o versiune a pachetului care oferă și CommonJS sau activează suportul pentru module ES.
Repară eroarea, direct în pagină
Proiectul are "type": "commonjs" în package.json, iar index.js dă SyntaxError: Unexpected token 'export', pentru că funcția formatLei a fost copiată dintr-un proiect cu module ES. Rescrie exportul în stil CommonJS, ca programul să afișeze totalul fiecărei comenzi.
const fs = require("fs");
export function formatLei(suma) {
return `${suma.toFixed(2)} lei`;
}
const comenzi = JSON.parse(fs.readFileSync("comenzi.json", "utf8"));
for (const c of comenzi) {
console.log(`${c.client}: ${formatLei(c.total)}`);
}Ana: 125.50 lei Mihai: 89.00 lei
Indiciu
Scoate cuvântul export din fața funcției și adaugă la final module.exports = { formatLei };.
Reparația
const fs = require("fs");
function formatLei(suma) {
return `${suma.toFixed(2)} lei`;
}
module.exports = { formatLei };
const comenzi = JSON.parse(fs.readFileSync("comenzi.json", "utf8"));
for (const c of comenzi) {
console.log(`${c.client}: ${formatLei(c.total)}`);
}De ce merge
"type": "commonjs" îi spune lui Node să citească fișierul ca CommonJS, unde export e un cuvânt necunoscut și oprește parsarea. Fără export, funcția e o declarație obișnuită, iar module.exports = { formatLei } o face disponibilă pentru alte fișiere prin require("./index"). Restul fișierului folosea deja require, deci acum totul e CommonJS consecvent.
Alte forme ale mesajului
SyntaxError: Unexpected token 'export' at wrapSafe (node:internal/modules/cjs/loader)SyntaxError: Unexpected token export/app/node_modules/pachet/index.js:1 export default function () {} ^^^^^^ SyntaxError: Unexpected token 'export'
Cum o eviți pe viitor
- Alege un singur sistem de module pentru proiect și scrie-l explicit în
package.json("type": "module"sau"type": "commonjs"). - Când copiezi cod de pe internet, verifică dacă e scris cu
import/exportsau curequire/module.exports. - Folosește extensiile
.mjsși.cjspentru fișierele care trebuie să fie de celălalt tip decât restul proiectului.
Întrebări frecvente
De ce merge fără package.json și pică după npm init?
Fără "type", Node 22+ detectează singur sintaxa ES și rulează fișierul ca modul ES. npm init adaugă "type": "commonjs", iar de atunci fișierul e tratat strict ca CommonJS.
Pot folosi export și require în același fișier?
Nu. Un fișier e fie CommonJS, fie modul ES. Într-un modul ES poți obține totuși un require cu createRequire(import.meta.url) din modulul node:module.
Erori înrudite
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. 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". SyntaxError: Cannot use 'import.meta' outside a module import.meta există doar în modulele ES, iar fișierul tău e rulat ca CommonJS. În CommonJS ai deja __dirname și __filename, deci înlocuiește path.dirname(fileURLToPath(import.meta.url)) cu __dirname, sau treci fișierul pe module ES cu "type": "module" ori extensia .mjs. Î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.
