...
Eroare Node.js · Fișiere și căi: fs și path

TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string or an instance of Buffer or URL. Received undefined

Pe scurt

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ă

Greșit
JavaScript
// rulat cu: node index.js
const fisier = process.argv[2];
fs.readFileSync(fisier, "utf8");
Corect
JavaScript
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ă

Greșit
JavaScript
const dir = process.env.DATA_DIR;
path.join(dir, "clienti.json");
Corect
JavaScript
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

Greșit
JavaScript
const config = { fisierLog: "app.log" };
fs.appendFileSync(config.fisier, "start\n");
Corect
JavaScript
const config = { fisierLog: "app.log" };
fs.appendFileSync(config.fisierLog, "start\n");

O proprietate inexistentă dă undefined, care ajunge apoi la fs.

Repară tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Fișier: note.txt
Linii: 3
Indiciu

Operatorul ?? îți dă valoarea din dreapta când cea din stânga e undefined.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received undefined
  • TypeError [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

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