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".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În modulele ES, Node nu mai pune la dispoziție variabilele CommonJS: require, module, exports, __dirname, __filename. Mesajul îți spune exact asta și îți sugerează soluția: folosește import.
Un fișier devine modul ES dacă are extensia .mjs, dacă package.json are "type": "module", sau (în Node recent) dacă fișierul .js conține sintaxă ES precum import ori export. Deci e suficient un singur import sus în fișier ca orice require de mai jos să dea această eroare.
Situații tipice: ai copiat un exemplu cu require într-un proiect cu "type": "module", sau ai amestecat cele două stiluri în același fișier.
De ce apare: cauzele frecvente
1import și require în același fișier
import path from "path";
const fs = require("fs");import path from "path";
import fs from "fs";Primul import face fișierul modul ES, iar acolo require nu e definit.
2Proiect cu "type": "module"
// package.json: { "type": "module" }
const express = require("express");// package.json: { "type": "module" }
import express from "express";Cu "type": "module", toate fișierele .js sunt module ES.
3Chiar ai nevoie de require într-un modul ES
const date = require("./date.json");import { createRequire } from "module";
const require = createRequire(import.meta.url);
const date = require("./date.json");createRequire îți creează o funcție require legată de fișierul curent, utilă pentru JSON sau pachete vechi.
Repară eroarea, direct în pagină
Fișierul de mai jos începe cu import, deci e modul ES, dar mai jos folosește require și dă ReferenceError: require is not defined in ES module scope. Transformă require în import, ca programul să afișeze numele fișierului și conținutul lui.
import path from "path";
const fs = require("fs");
const fisier = "note.txt";
console.log(`Fișier: ${path.basename(fisier, ".txt")}`);
console.log(fs.readFileSync(fisier, "utf8").trim());Fișier: note Cumpără lapte Sună la bancă
Indiciu
const fs = require("fs"); se scrie în modul ES import fs from "fs"; și trebuie să stea sus, lângă celălalt import.
Reparația
import path from "path";
import fs from "fs";
const fisier = "note.txt";
console.log(`Fișier: ${path.basename(fisier, ".txt")}`);
console.log(fs.readFileSync(fisier, "utf8").trim());De ce merge
Un fișier .js care conține import este încărcat de Node ca modul ES. În modulele ES nu există require, module.exports sau __dirname; modulele se încarcă doar cu import. Instrucțiunea import fs from "fs" îți dă același obiect fs ca require("fs"). Importurile statice se scriu la începutul fișierului, pentru că Node le rezolvă înainte să ruleze codul.
Alte forme ale mesajului
ReferenceError: require is not definedReferenceError: exports is not defined in ES module scopeReferenceError: require is not defined in ES module scope, you can use import instead This file is being treated as an ES module because it has a '.js' file extension and '/app/package.json' contains "type": "module".
Cum o eviți pe viitor
- Alege un stil per proiect: modulele ES cu
import, sau CommonJS curequire. - Când copiezi cod, transformă imediat
requireînimport(sau invers) ca să se potrivească proiectului. - Pentru JSON în module ES folosește
fs.readFileSync+JSON.parsesauimport date from "./date.json" with { type: "json" }. - Dacă un singur fișier trebuie să rămână CommonJS, dă-i extensia
.cjs.
Întrebări frecvente
Cum import un modul CommonJS dintr-un modul ES?
Cu import x from "./modul.cjs": ce era în module.exports devine exportul implicit. De multe ori merg și importurile cu nume, dacă Node le poate detecta.
În browser primesc doar „require is not defined”. E aceeași problemă?
Asemănătoare: browserul nu are deloc require. Acolo folosești <script type="module"> cu import, sau un bundler.
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: __dirname is not defined in ES module scope În modulele ES nu există __dirname și __filename. Folosește import.meta.dirname și import.meta.filename (Node 20.11+) sau calculează-le din import.meta.url cu fileURLToPath și path.dirname. ReferenceError: module is not defined in ES module scope Folosești module.exports într-un fișier care e modul ES (are import, extensia .mjs sau "type": "module"). În modulele ES exporți cu export: module.exports = { a, b } devine export { a, b } sau export default. Î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.
