...
Eroare Node.js · Asincron: callback-uri, promisiuni și timere

TypeError [ERR_INVALID_ARG_TYPE]: The "cb" argument must be of type function. Received undefined

Pe scurt

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ă

Greșit
JavaScript
const text = fs.readFile("note.txt", "utf8");
console.log(text);
Corect
JavaScript
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

Greșit
JavaScript
const fs = require("fs");
const text = await fs.readFile("note.txt", "utf8");
Corect
JavaScript
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

Greșit
JavaScript
const lista = fs.readdir("date");
Corect
JavaScript
const lista = fs.readdirSync("date");

Varianta Sync blochează până la final și întoarce direct rezultatul; e potrivită în scripturi mici.

Repară tu

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.

Codul care dă eroarea
JavaScript
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`);
După reparație, programul afișează
Comenzi: 3
Total: 235 lei
Indiciu

fs.readFile("comenzi.json", "utf8", (err, text) => { ... }): codul care folosește textul se mută î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 Object
  • TypeError [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/promises cu async/await, e cel mai ușor de citit.
  • Pentru scripturi simple, varianta Sync e î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

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