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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Funcțiile din fs (readFileSync, writeFileSync, existsSync...) și din path (join, resolve, basename) au nevoie de o cale de tip text (sau Buffer/URL la fs). ERR_INVALID_ARG_TYPE înseamnă că argumentul are alt tip, iar finalul mesajului îți spune ce ai trimis de fapt: Received undefined.
Deci problema nu e la fișier, ci la variabila din care vine calea. Surse frecvente: process.argv[2] când rulezi scriptul fără argument, process.env.DATA_DIR nesetată, o proprietate cu nume greșit (config.fisier în loc de config.file) sau o funcție care nu întoarce nimic.
La path.join mesajul e ușor diferit: The "path" argument must be of type string. Received undefined.
De ce apare: cauzele frecvente
1Argument lipsă din linia de comandă
// rulat cu: node index.js
const fisier = process.argv[2];
fs.readFileSync(fisier, "utf8");const fisier = process.argv[2] ?? "note.txt";
fs.readFileSync(fisier, "utf8");Fără argument, process.argv[2] este undefined. Cu ?? folosești o valoare implicită.
2Variabilă de mediu nesetată
const dir = process.env.DATA_DIR;
path.join(dir, "clienti.json");const dir = process.env.DATA_DIR ?? "date";
path.join(dir, "clienti.json");O variabilă de mediu care nu există are valoarea undefined.
3Proprietate scrisă greșit
const config = { fisierLog: "app.log" };
fs.appendFileSync(config.fisier, "start\n");const config = { fisierLog: "app.log" };
fs.appendFileSync(config.fisierLog, "start\n");O proprietate inexistentă dă undefined, care ajunge apoi la fs.
Repară eroarea, direct în pagină
Scriptul citește fișierul primit ca argument (node index.js note.txt), dar a fost pornit fără argument și dă TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string... Received undefined. Folosește note.txt ca valoare implicită când argumentul lipsește, ca programul să afișeze fișierul citit și numărul de linii.
const fs = require("fs");
const fisier = process.argv[2];
const text = fs.readFileSync(fisier, "utf8");
console.log(`Fișier: ${fisier}`);
console.log(`Linii: ${text.trim().split("\n").length}`);Fișier: note.txt Linii: 3
Indiciu
Operatorul ?? îți dă valoarea din dreapta când cea din stânga e undefined.
Reparația
const fs = require("fs");
const fisier = process.argv[2] ?? "note.txt";
const text = fs.readFileSync(fisier, "utf8");
console.log(`Fișier: ${fisier}`);
console.log(`Linii: ${text.trim().split("\n").length}`);De ce merge
process.argv conține calea către node, calea scriptului și abia apoi argumentele tale. Pornit fără argument, process.argv[2] este undefined, iar readFileSync refuză orice cale care nu e text, Buffer sau URL. Cu process.argv[2] ?? "note.txt" variabila are mereu un text: argumentul dacă există, altfel numele implicit. Într-un script real poți afișa în loc un mesaj de folosire și ieși cu process.exit(1).
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received undefinedTypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string or an instance of Buffer or URL. Received type number (3)TypeError [ERR_INVALID_ARG_TYPE]: The "paths[1]" argument must be of type string. Received undefined
Cum o eviți pe viitor
- Validează argumentele la începutul scriptului și afișează un mesaj de folosire:
Folosire: node index.js <fisier>. - Pune valori implicite pentru argumente și variabile de mediu cu
??. - Când apare eroarea, afișează variabila cu calea chiar înainte de apel ca să vezi de unde vine
undefined.
Întrebări frecvente
De ce e process.argv[2] și nu [0]?
process.argv[0] e calea către programul node, process.argv[1] e scriptul, iar argumentele tale încep de la process.argv[2].
Ce înseamnă paths[1] din varianta mesajului?
La path.join(a, b), argumentele sunt numerotate de la 0. paths[1] înseamnă că al doilea argument e cel greșit.
Erori înrudite
TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Object Încerci să scrii în fișier un obiect sau un tablou direct, dar writeFileSync și appendFileSync acceptă doar text sau Buffer. Transformă datele în text: JSON.stringify(date, null, 2) pentru JSON, sau String(numar) pentru numere. Error: ENOENT: no such file or directory, open 'date.txt' Fișierul pe care vrei să-l deschizi nu există la calea dată, sau dosarul în care vrei să scrii lipsește. Calea relativă pornește din dosarul din care rulezi node, nu din dosarul scriptului. Verifică calea, construiește-o cu path.join(__dirname, ...) și creează dosarul înainte de scriere. TypeError [ERR_INVALID_ARG_TYPE]: The "key" argument must be of type string or an instance of ArrayBuffer, Buffer, TypedArray, DataView, KeyObject, or CryptoKey. Received undefined Cheia secretă dată lui crypto.createHmac (sau unei funcții de semnare, ca la JWT) e undefined: variabila de mediu nu e setată, fișierul de configurare nu are cheia sau numele proprietății e greșit. Verifică de unde vine cheia și oprește aplicația cu un mesaj clar dacă lipsește. Î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.
