TypeError [ERR_INVALID_ARG_VALUE]: The argument 'id' must be a non-empty string. Received ''
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
const plugin = require(process.env.PLUGIN || "");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
const linii = fs.readFileSync("pluginuri.txt", "utf8").split("\n");
for (const cale of linii) require(cale);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ă
// node index.js (fără argument)
const raport = require(process.argv[2] ?? "");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ă 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.
const numePlugin = process.env.PLUGIN_EXPORT || "";
const exporta = require(numePlugin);
const vanzari = [
{ produs: "Cafea", suma: 120 },
{ produs: "Ceai", suma: 45 },
];
console.log(exporta(vanzari));produs,suma Cafea,120 Ceai,45
Indiciu
Înlocuiește "" din dreapta lui || cu calea modulului implicit.
Reparația
const numePlugin = process.env.PLUGIN_EXPORT || "./pluginuri/csv";
const exporta = require(numePlugin);
const vanzari = [
{ produs: "Cafea", suma: 120 },
{ produs: "Ceai", suma: 45 },
];
console.log(exporta(vanzari));De ce merge
process.env.PLUGIN_EXPORT nu e setată, deci || alege valoarea din dreapta. Cu "", require primește un text gol și îl respinge, pentru că nu e un nume de modul. Cu "./pluginuri/csv" ca valoare implicită, programul merge și fără variabila de mediu, iar cine vrea alt format o poate seta când pornește programul.
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
TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received undefined Ai apelat require() cu o valoare care nu e text, de obicei undefined: o variabilă necompletată, o cheie scrisă greșit în config sau o variabilă de mediu lipsă. Afișează valoarea înainte de require și dă-i mereu o cale validă, de exemplu "./formatare/lei". Error: Cannot find module './calcul' Node nu găsește fișierul pe care îl ceri cu require: calea e scrisă greșit, fișierul are alt nume sau e în alt dosar. Verifică numele exact al fișierului și calea relativă față de fișierul care face require, de exemplu require("./calcule") sau require("./lib/calcule"). TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string or an instance of Buffer or URL. Received undefined Ai dat unei funcții din fs sau path o cale care este undefined, nu un text. De obicei vine din process.argv[2] lipsă, o proprietate scrisă greșit sau o variabilă de mediu nesetată. Verifică variabila și pune o valoare implicită. Î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.
