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

ReferenceError: require is not defined in ES module scope, you can use import instead

Pe scurt

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

Greșit
JavaScript
import path from "path";
const fs = require("fs");
Corect
JavaScript
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"

Greșit
JavaScript
// package.json: { "type": "module" }
const express = require("express");
Corect
JavaScript
// 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

Greșit
JavaScript
const date = require("./date.json");
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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());
După reparație, programul afișează
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.

Alte forme ale mesajului

  • ReferenceError: require is not defined
  • ReferenceError: exports is not defined in ES module scope
  • ReferenceError: 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 cu require.
  • Când copiezi cod, transformă imediat require în import (sau invers) ca să se potrivească proiectului.
  • Pentru JSON în module ES folosește fs.readFileSync + JSON.parse sau import 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

← 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.