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

TypeError [ERR_INVALID_ARG_TYPE]: The "pathObject" argument must be of type object. Received type string ('raport.txt')

Pe scurt

path.format() primește un obiect cu părțile căii ({ dir, name, ext }), nu un string. Ca să schimbi extensia, desparte calea cu path.parse(), modifică obiectul (fără base) și dă-l lui path.format(); pentru lipit bucăți de cale folosește path.join().

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

Ce înseamnă

path.format face inversul lui path.parse: primește un obiect de forma { root, dir, base, name, ext } și construiește string-ul căii. Argumentul se numește intern pathObject, de aceea apare în mesaj.

Received type string ('raport.txt') spune că ai trimis direct un string. Asta se întâmplă când crezi că path.format „formatează” sau curăță o cale (asta face path.normalize), sau când încerci path.format(cale, { ext: ".md" }), ca și cum al doilea argument ar fi opțiuni.

O capcană înrudită, fără eroare: dacă obiectul are și base, path.format ignoră name și ext. De aceea, când schimbi extensia, scoate base din obiectul dat de path.parse.

De ce apare: cauzele frecvente

1Schimbarea extensiei cu un string

Greșit
JavaScript
path.format("raport.txt", { ext: ".md" });
Corect
JavaScript
const { dir, name } = path.parse("raport.txt");
path.format({ dir, name, ext: ".md" }); // 'raport.md'

path.format așteaptă un singur obiect cu părțile căii. Construiești obiectul din path.parse, fără base.

2Confuzie cu path.normalize

Greșit
JavaScript
path.format("date//2024/../raport.txt");
Corect
JavaScript
path.normalize("date//2024/../raport.txt"); // 'date/raport.txt'

Pentru curățarea unei căi (slash-uri duble, ..) funcția potrivită este path.normalize.

3Lipirea bucăților de cale

Greșit
JavaScript
path.format("export", "raport.csv");
Corect
JavaScript
path.join("export", "raport.csv"); // 'export/raport.csv'

path.join primește oricâte string-uri și le unește cu separatorul corect.

Repară tu

Repară eroarea, direct în pagină

Funcția schimbaExtensia ar trebui să transforme numele rapoartelor din .txt în .md, dar trimite string-ul direct la path.format și primește The "pathObject" argument must be of type object. Repar-o folosind path.parse și path.format, ca să afișeze cele două căi noi.

Codul care dă eroarea
JavaScript
const path = require("path");

function schimbaExtensia(cale, nouaExt) {
  return path.format(cale, { ext: nouaExt });
}

console.log(schimbaExtensia("rapoarte/ianuarie.txt", ".md"));
console.log(schimbaExtensia("note.txt", ".md"));
După reparație, programul afișează
rapoarte/ianuarie.md
note.md
Indiciu

Ia dir și name din path.parse(cale) și dă-le lui path.format împreună cu ext: nouaExt.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "pathObject" argument must be of type object. Received undefined
  • TypeError [ERR_INVALID_ARG_TYPE]: The "pathObject" argument must be of type object. Received null
  • TypeError [ERR_INVALID_ARG_TYPE]: The "pathObject" argument must be of type object. Received type string ('/app/poze/vacanta.jpg')

Cum o eviți pe viitor

  • Reține perechea: path.parse(string) dă obiect, path.format(obiect) dă string.
  • Când schimbi numele sau extensia, nu pune base în obiect (are prioritate față de name + ext).
  • Pentru unire de căi folosește path.join, pentru curățare path.normalize, pentru cale absolută path.resolve.

Întrebări frecvente

De ce path.format({ ...path.parse(f), ext: ".md" }) nu schimbă extensia?

Pentru că obiectul are încă base: "raport.txt", iar base are prioritate. Scoate-l: const { base, ...rest } = path.parse(f); path.format({ ...rest, ext: ".md" }).

Trebuie să pun punctul în ext?

Din Node 20, path.format adaugă singur punctul dacă lipsește, dar e mai clar să scrii .md, exact cum îl întoarce path.parse.

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.