TypeError [ERR_INVALID_ARG_TYPE]: The "cb" argument must be of type function. Received undefined
Ai apelat o funcție asincronă din fs (readFile, writeFile, readdir...) fără callback, ca și cum ar întoarce direct rezultatul. Ori dai un callback (err, date) => {...}, ori folosești varianta Sync, ori fs/promises cu await.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Funcțiile din modulul fs fără Sync în nume (fs.readFile, fs.writeFile, fs.readdir, fs.unlink) sunt asincrone cu callback: nu întorc rezultatul, ci îl dau mai târziu funcției pe care o trimiți ca ultim argument, (err, rezultat) => {...}. Node verifică argumentul acela; dacă lipsește, aruncă imediat această eroare.
Situația tipică: scrii const text = fs.readFile("note.txt", "utf8") așteptând textul, sau folosești await fs.readFile(...) cu modulul fs obișnuit (cel cu promisiuni este fs/promises). Când lipsește callback-ul, dar ai dat codificarea, mesajul se termină cu Received type string ('utf8'), pentru că Node a luat ultimul argument drept callback.
De ce apare: cauzele frecvente
1readFile folosit ca funcție sincronă
const text = fs.readFile("note.txt", "utf8");
console.log(text);fs.readFile("note.txt", "utf8", (err, text) => {
if (err) return console.log(err.message);
console.log(text);
});Rezultatul vine în callback, după ce fișierul a fost citit.
2await cu modulul fs obișnuit
const fs = require("fs");
const text = await fs.readFile("note.txt", "utf8");const fs = require("fs/promises");
const text = await fs.readFile("note.txt", "utf8");Doar funcțiile din fs/promises întorc promisiuni care pot fi așteptate cu await.
3Vrei pur și simplu rezultatul imediat
const lista = fs.readdir("date");const lista = fs.readdirSync("date");Varianta Sync blochează până la final și întoarce direct rezultatul; e potrivită în scripturi mici.
Repară eroarea, direct în pagină
Programul citește comenzile cu fs.readFile ca și cum ar întoarce direct conținutul și dă TypeError [ERR_INVALID_ARG_TYPE]: The "cb" argument must be of type function. Received undefined. Primește conținutul printr-un callback error-first (err, text), ca programul să afișeze numărul de comenzi și totalul.
const fs = require("fs");
const text = fs.readFile("comenzi.json");
const comenzi = JSON.parse(text);
const total = comenzi.reduce((s, c) => s + c.suma, 0);
console.log(`Comenzi: ${comenzi.length}`);
console.log(`Total: ${total} lei`);Comenzi: 3 Total: 235 lei
Indiciu
fs.readFile("comenzi.json", "utf8", (err, text) => { ... }): codul care folosește textul se mută în callback.
Reparația
const fs = require("fs");
fs.readFile("comenzi.json", "utf8", (err, text) => {
if (err) {
console.log(`Nu pot citi comenzile: ${err.message}`);
return;
}
const comenzi = JSON.parse(text);
const total = comenzi.reduce((s, c) => s + c.suma, 0);
console.log(`Comenzi: ${comenzi.length}`);
console.log(`Total: ${total} lei`);
});De ce merge
fs.readFile nu așteaptă citirea: pornește operația și îți dă rezultatul mai târziu, prin funcția pe care o trimiți ca ultim argument. Fără ea, Node nu are unde să livreze conținutul și aruncă imediat ERR_INVALID_ARG_TYPE. În callback, primul argument e eroarea (de exemplu ENOENT), iar al doilea textul fișierului, deci întâi tratezi err, apoi folosești datele. Codul care depinde de conținut trebuie să stea în callback.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "cb" argument must be of type function. Received type string ('utf8')TypeError [ERR_INVALID_ARG_TYPE]: The "cb" argument must be of type function. Received an instance of ObjectTypeError [ERR_INVALID_ARG_TYPE]: The "callback" argument must be of type function. Received undefined
Cum o eviți pe viitor
- Reține regula: fără
Syncși fărăpromises= callback obligatoriu. - În cod nou folosește
fs/promisescuasync/await, e cel mai ușor de citit. - Pentru scripturi simple, varianta
Synce în regulă. - Nu amesteca stilurile în același fișier.
Întrebări frecvente
De ce callback-ul primește mai întâi err?
E convenția Node numită error-first: primul argument e eroarea (sau null dacă totul a mers), iar rezultatul vine al doilea. Verifici mereu err înainte să folosești rezultatul.
Ce aleg: callback, Sync sau promisiuni?
Promisiunile cu await sunt standardul modern. Sync e bun în scripturi mici și la pornire. Callback-urile le vei întâlni în cod mai vechi.
Erori înrudite
TypeError: fs.readFileSync is not a function Ai importat varianta cu promisiuni a modulului (require("fs/promises") sau fs.promises), care are doar funcții asincrone, fără Sync. Folosește await fs.readFile(...) din fs/promises, sau importă modulul obișnuit "fs" dacă vrei readFileSync. TypeError [ERR_INVALID_ARG_TYPE]: The "callback" argument must be of type function. Received undefined Ai dat lui setTimeout, setInterval sau setImmediate rezultatul unei funcții în loc de funcția însăși, de obicei scriind setTimeout(trimite(), 1000). Pune funcția fără paranteze, setTimeout(trimite, 1000), sau într-o funcție săgeată: setTimeout(() => trimite("Ana"), 1000). 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. Î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.
