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".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
id este numele parametrului lui require(id): textul care spune ce modul vrei să încarci ("fs", "express", "./utils"). Mesajul spune că parametrul trebuie să fie de tip string, dar a primit altceva, aici undefined.
Asta nu se întâmplă când scrii calea direct în cod, ci când o iei dintr-o variabilă: require(config.modul), require(process.env.DRIVER), require(pluginuri[i]). Dacă proprietatea nu există (nume greșit, cheie lipsă în JSON, variabilă de mediu nesetată), valoarea e undefined, iar Node refuză încă dinainte să caute fișierul.
Partea Received ... îți arată ce a primit: undefined, type number (3), an instance of Object. În stiva de apeluri caută primul rând din fișierele tale (at Object.<anonymous> (/app/index.js:2:...)): acolo e require-ul cu problema.
De ce apare: cauzele frecvente
1Cheie scrisă greșit în configurație
// config.json: { "formatare": "./formatare/lei" }
const config = require("./config.json");
const formateaza = require(config.formatter);const config = require("./config.json");
const formateaza = require(config.formatare);config.formatter nu există, deci e undefined. Cu numele corect al cheii primești calea, iar require găsește modulul.
2Variabilă de mediu nesetată
const driver = require(process.env.DB_DRIVER);const driver = require(process.env.DB_DRIVER || "./db/memorie");Variabilele de mediu lipsă sunt undefined. O valoare implicită face programul să meargă și pe un calculator unde nu ai setat variabila.
3Obiect în loc de text
const pluginuri = [{ cale: "./pluginuri/tva" }];
for (const p of pluginuri) require(p);const pluginuri = [{ cale: "./pluginuri/tva" }];
for (const p of pluginuri) require(p.cale);require primește doar text. Din obiect trebuie să iei proprietatea care conține calea.
Repară eroarea, direct în pagină
Programul încarcă funcția de formatare a prețurilor după calea scrisă în config.json, dar cheia folosită în cod nu există în fișier, așa că primește TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received undefined. Folosește cheia corectă din configurație, ca programul să afișeze cele trei prețuri formatate.
const config = require("./config.json");
const formateaza = require(config.formatter);
for (const suma of [42, 7.5, 120]) {
console.log(formateaza(suma));
}42.00 lei 7.50 lei 120.00 lei
Indiciu
Deschide config.json și compară numele cheii cu cel din config.formatter.
Reparația
const config = require("./config.json");
const formateaza = require(config.formatare);
for (const suma of [42, 7.5, 120]) {
console.log(formateaza(suma));
}De ce merge
În config.json cheia se numește formatare, deci config.formatter era undefined, iar require(undefined) e respins înainte de orice căutare. Cu config.formatare, require primește textul "./formatare/lei", îl rezolvă față de fișierul curent și întoarce funcția exportată de modul.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received type number (3)TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received an instance of ObjectTypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received null
Cum o eviți pe viitor
- Scrie căile de module direct în cod ori de câte ori poți:
require("./formatare/lei"). - Când calea vine din configurație sau din
process.env, verific-o înainte:if (typeof cale !== "string") throw new Error("Lipsește calea modulului"). - Pune valori implicite pentru variabilele de mediu:
process.env.X || "./implicit". - La depanare, afișează valoarea:
console.log({ cale })chiar înainte derequire.
Întrebări frecvente
Cu ce e diferită de Cannot find module?
La Cannot find module Node a primit un text, l-a căutat și nu a găsit fișierul. Aici nici nu a ajuns să caute: nu a primit deloc un text.
De ce apare doar pe serverul de producție?
Pentru că acolo lipsește o variabilă de mediu sau o cheie din fișierul de configurare pe care ai setat-o doar local. Verifică ce valori are procesul pe server.
Erori înrudite
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_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. 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.
