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

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

Pe scurt

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

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

Ce înseamnă

setTimeout(callback, ms) vrea ca prim argument o funcție pe care s-o apeleze mai târziu. Dacă scrii setTimeout(trimiteReminder(), 1000), parantezele apelează funcția imediat, iar ce ajunge la setTimeout este valoarea întoarsă de ea, de obicei undefined. Node verifică argumentul și aruncă eroarea, cu Received undefined la final.

Indiciu clar: codul din funcție rulează imediat (vezi mesajul afișat înainte de eroare), nu după întârziere. Același lucru se întâmplă la setInterval, setImmediate, process.nextTick și la funcțiile care primesc callback-uri, unde varianta de mesaj diferă ușor.

De ce apare: cauzele frecvente

1Paranteze după numele funcției

Greșit
JavaScript
function salveaza() { console.log("Salvat"); }
setTimeout(salveaza(), 1000);
Corect
JavaScript
function salveaza() { console.log("Salvat"); }
setTimeout(salveaza, 1000);

Fără paranteze transmiți funcția; cu paranteze transmiți ce întoarce ea.

2Funcția are nevoie de argumente

Greșit
JavaScript
setTimeout(trimiteReminder("Ana"), 1000);
Corect
JavaScript
setTimeout(() => trimiteReminder("Ana"), 1000);
// sau: setTimeout(trimiteReminder, 1000, "Ana");

O funcție săgeată amână apelul până la expirarea timpului, iar argumentele rămân în ea.

3Ordinea argumentelor inversată

Greșit
JavaScript
setTimeout(1000, () => console.log("Gata"));
Corect
JavaScript
setTimeout(() => console.log("Gata"), 1000);

Funcția este primul argument, întârzierea în milisecunde al doilea.

Repară tu

Repară eroarea, direct în pagină

Programul trebuie să trimită două remindere după o mică întârziere, dar dă TypeError [ERR_INVALID_ARG_TYPE]: The "callback" argument must be of type function. Received undefined imediat după primul mesaj. Programează corect cele două apeluri, ca mesajele să apară după Remindere programate.

Codul care dă eroarea
JavaScript
function trimiteReminder(nume, motiv) {
  console.log(`Reminder pentru ${nume}: ${motiv}`);
}

setTimeout(trimiteReminder("Ana", "plata facturii"), 100);
setTimeout(trimiteReminder("Mihai", "programarea de mâine"), 200);
console.log("Remindere programate");
După reparație, programul afișează
Remindere programate
Reminder pentru Ana: plata facturii
Reminder pentru Mihai: programarea de mâine
Indiciu

Învelește fiecare apel într-o funcție săgeată: setTimeout(() => trimiteReminder("Ana", "plata"), 100).

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "callback" argument must be of type function. Received type number (1000)
  • TypeError [ERR_INVALID_ARG_TYPE]: The "callback" argument must be of type function. Received an instance of Promise
  • TypeError [ERR_INVALID_ARG_TYPE]: The "listener" argument must be of type function. Received undefined

Cum o eviți pe viitor

  • Când transmiți o funcție, nu pune paranteze după nume.
  • Dacă trebuie să dai argumente, învelește apelul într-o funcție săgeată.
  • Dacă vezi că un cod „programat” rulează imediat, caută parantezele în plus.
  • Pentru așteptări în cod async, folosește await setTimeout(ms) din timers/promises.

Întrebări frecvente

De ce funcția mea a rulat totuși o dată?

Pentru că parantezele au apelat-o imediat, înainte să ajungă la setTimeout. Abia apoi Node a văzut că a primit undefined și a aruncat eroarea.

Merge setTimeout cu o funcție async?

Da, setTimeout(async () => { await ... }, 1000) e corect, pentru că dai o funcție. Greșit ar fi setTimeout(salveazaAsync(), 1000), care dă o promisiune.

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.