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

TypeError: callback is not a function

Pe scurt

Funcția ta așteaptă un callback ca ultim argument, dar a fost apelată fără el (sau cu argumentele în altă ordine), așa că la final callback e undefined. Dă-i funcția care primește rezultatul: citeste(fisier, (err, date) => { ... }), sau rescrie funcția să întoarcă o promisiune.

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

Ce înseamnă

În stilul clasic Node, o funcție asincronă nu întoarce rezultatul, ci îl trimite unei funcții primite ca ultim argument: callback(err, rezultat). Dacă apelezi funcția fără acest argument, parametrul callback e undefined, iar linia callback(...) dă callback is not a function.

Eroarea apare de obicei mai târziu decât apelul greșit: abia când operația asincronă (citirea fișierului, cererea, timer-ul) s-a terminat. De aceea stiva arată linia din interiorul funcției tale, nu locul în care ai uitat argumentul. Caută toate apelurile funcției și verifică dacă fiecare îi dă un callback.

Alte forme ale aceleiași probleme: cb is not a function, done is not a function. Cauze frecvente: ai tratat funcția ca și cum ar întoarce valoarea (const date = citeste("a.json")), ai inversat argumentele sau ai trecut rezultatul unui apel în loc de funcție (citeste(f, afiseaza())).

De ce apare: cauzele frecvente

1Funcția cu callback folosită ca și cum ar întoarce valoarea

Greșit
JavaScript
const comenzi = citesteComenzi("comenzi.json");
console.log(comenzi);
Corect
JavaScript
citesteComenzi("comenzi.json", (err, comenzi) => {
  if (err) return console.error(err.message);
  console.log(comenzi);
});

Rezultatul ajunge doar în callback; fără callback, funcția nu are cui să-l trimită.

2Rezultatul unui apel în loc de funcție

Greșit
JavaScript
citesteComenzi("comenzi.json", afiseaza());
Corect
JavaScript
citesteComenzi("comenzi.json", afiseaza);

afiseaza() rulează imediat și trimite ce întoarce (de obicei undefined). Fără paranteze trimiți funcția însăși.

3Funcție scrisă pentru promisiuni, nu pentru callback

Greșit
JavaScript
function citesteComenzi(fisier, callback) { /* ... */ }
Corect
JavaScript
async function citesteComenzi(fisier) {
  const text = await fs.promises.readFile(fisier, "utf8");
  return JSON.parse(text);
}
const comenzi = await citesteComenzi("comenzi.json");

Cu async/await rezultatul e întors direct, fără niciun callback de uitat.

Repară tu

Repară eroarea, direct în pagină

Funcția citesteComenzi trimite rezultatul printr-un callback, dar e apelată ca și cum ar întoarce comenzile, iar programul dă TypeError: callback is not a function. Apeleaz-o corect, cu un callback care afișează fiecare comandă (sau mesajul erorii, dacă citirea eșuează).

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

function citesteComenzi(fisier, callback) {
  fs.readFile(fisier, "utf8", (err, text) => {
    if (err) return callback(err);
    callback(null, JSON.parse(text));
  });
}

const comenzi = citesteComenzi("comenzi.json");
console.log("Citesc comenzile...");
console.log(comenzi);
După reparație, programul afișează
Citesc comenzile...
Ana: 125.5 lei
Mihai: 89 lei
Indiciu

Al doilea argument trebuie să fie o funcție (err, comenzi) => { ... }.

Alte forme ale mesajului

  • TypeError: cb is not a function
  • TypeError: done is not a function
  • TypeError: callback is not a function at FSReqCallback.readFileAfterClose [as oncomplete] (node:internal/fs/read/context)

Cum o eviți pe viitor

  • Pentru cod nou, preferă funcții async care întorc promisiuni, nu callback-uri.
  • Dacă scrii funcții cu callback, verifică la început: if (typeof callback !== "function") throw new TypeError("Lipsește callback-ul"), ca eroarea să apară chiar la apelul greșit.
  • Folosește util.promisify ca să transformi funcțiile vechi cu callback în funcții cu promisiuni.

Întrebări frecvente

De ce stiva arată interiorul funcției, nu apelul greșit?

Callback-ul e apelat după ce operația asincronă se termină, dintr-o altă iterație a event loop-ului. Apelul inițial s-a încheiat de mult, așa că nu mai apare în stivă.

E aceeași eroare ca The "cb" argument must be of type function?

Seamănă, dar acea eroare vine din funcțiile lui Node (de exemplu fs.readFile fără callback) și apare imediat. callback is not a function vine din codul tău, când apelezi un parametru care nu a fost dat.

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.