...
Eroare Node.js · Module CommonJS: require și module.exports

TypeError [ERR_INVALID_ARG_VALUE]: The argument 'id' must be a non-empty string. Received ''

Pe scurt

Ai apelat require(""), cu un text gol. De obicei calea vine dintr-o variabilă de mediu sau dintr-un argument care lipsește, iar codul pune "" ca valoare implicită. Folosește o cale reală ca valoare implicită sau verifică textul înainte de require.

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

Ce înseamnă

Eroarea e sora lui The "id" argument must be of type string: de data asta require a primit un text, dar textul e gol. Node nu are ce căuta, așa că respinge apelul cu ERR_INVALID_ARG_VALUE (valoare invalidă, nu tip invalid).

Un text gol apare rar scris direct. Apare când calea e construită: require(process.env.PLUGIN || ""), require(process.argv[2] ?? ""), require(config.driver.trim()) cu o cheie goală în JSON, sau un șir de căi citit dintr-un fișier care are o linie goală la final (text.split("\n") dă "" pentru ultima linie).

În stiva de apeluri caută primul rând din fișierele tale: acolo e require-ul. Afișează valoarea cu console.log(JSON.stringify(cale)): ghilimelele goale "" se văd imediat.

De ce apare: cauzele frecvente

1Valoare implicită goală pentru o variabilă de mediu

Greșit
JavaScript
const plugin = require(process.env.PLUGIN || "");
Corect
JavaScript
const plugin = require(process.env.PLUGIN || "./pluginuri/implicit");

Valoarea implicită trebuie să fie o cale validă, nu un text gol.

2Linie goală la finalul unei liste de module

Greșit
JavaScript
const linii = fs.readFileSync("pluginuri.txt", "utf8").split("\n");
for (const cale of linii) require(cale);
Corect
JavaScript
const linii = fs.readFileSync("pluginuri.txt", "utf8").split("\n");
for (const cale of linii.filter(Boolean)) require(cale);

Un fișier care se termină cu \n produce un ultim element "" la split. filter(Boolean) elimină textele goale.

3Argument lipsă din linia de comandă

Greșit
JavaScript
// node index.js   (fără argument)
const raport = require(process.argv[2] ?? "");
Corect
JavaScript
const cale = process.argv[2];
if (!cale) {
  console.log("Folosire: node index.js ./rapoarte/lunar");
  process.exit(1);
}
const raport = require(cale);

Când argumentul lipsește, un mesaj de folosire e mult mai clar decât o eroare internă.

Repară tu

Repară eroarea, direct în pagină

Programul alege modulul de export după variabila de mediu PLUGIN_EXPORT. Când variabila lipsește, folosește un text gol, iar require se oprește cu TypeError [ERR_INVALID_ARG_VALUE]: The argument 'id' must be a non-empty string. Received ''. Pune ca valoare implicită modulul ./pluginuri/csv, ca programul să afișeze vânzările în format CSV.

Codul care dă eroarea
JavaScript
const numePlugin = process.env.PLUGIN_EXPORT || "";
const exporta = require(numePlugin);

const vanzari = [
  { produs: "Cafea", suma: 120 },
  { produs: "Ceai", suma: 45 },
];

console.log(exporta(vanzari));
După reparație, programul afișează
produs,suma
Cafea,120
Ceai,45
Indiciu

Înlocuiește "" din dreapta lui || cu calea modulului implicit.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_VALUE]: The argument 'id' must be a non-empty string. Received ''
  • TypeError: The argument 'id' must be a non-empty string. Received ''

Cum o eviți pe viitor

  • Nu folosi niciodată "" ca valoare implicită pentru o cale: pune calea modulului implicit.
  • Filtrează liniile goale când citești liste din fișiere: .split("\n").filter(Boolean) sau .trim().split("\n").
  • Validează argumentele din linia de comandă și afișează un mesaj de folosire când lipsesc.
  • La depanare, afișează valoarea cu JSON.stringify, ca să vezi și textele goale sau spațiile.

Întrebări frecvente

De ce nu primesc Cannot find module?

Pentru că un text gol nu e un nume de modul: Node îl respinge înainte să caute ceva. Cannot find module apare doar după o căutare care a eșuat.

Și import("") în module ES?

Și acolo un specificator gol e invalid, dar mesajul e altul. Regula e aceeași: verifică textul înainte să-l imporți.

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.