...
Eroare Node.js · Express

Error: Route.get() requires a callback function but got a [object Undefined]

Pe scurt

Funcția dată ca handler pentru app.get, app.post sau router.get este undefined: e importată cu alt nume decât cel exportat, nu e exportată din controller sau e scrisă greșit. Verifică exporturile controllerului și numele folosit în rută.

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

Ce înseamnă

app.get(cale, handler) are nevoie de o funcție (req, res) pe care s-o apeleze la fiecare cerere. Mesajul (din Express 4) spune că în locul funcției a primit undefined ([object Undefined]); Express 5 dă în schimb TypeError: argument handler must be a function. Eroarea apare la pornire, pe linia unde definești ruta, iar metoda din mesaj (Route.get, Route.post) îți arată ce fel de rută e.

Cauza obișnuită e în legătura dintre fișierul de rute și controller: controller.lista când controllerul exportă listaProduse, o funcție uitată din module.exports, o dependență circulară între fișiere, sau handler-ul apelat la înregistrare (app.get("/", lista())), care dă rezultatul funcției în loc de funcție.

De ce apare: cauzele frecvente

1Numele diferă de cel exportat

Greșit
JavaScript
// controller: module.exports = { listaProduse };
app.get("/api/produse", controller.lista);
Corect
JavaScript
app.get("/api/produse", controller.listaProduse);

O proprietate care nu există în obiectul exportat este undefined.

2Funcția nu e exportată

Greșit
JavaScript
// controller.js
function sterge(req, res) { /* ... */ }
module.exports = { lista };
Corect
JavaScript
// controller.js
function sterge(req, res) { /* ... */ }
module.exports = { lista, sterge };

Ce nu e în module.exports nu poate fi folosit din alt fișier.

3Handler-ul e apelat la înregistrare

Greșit
JavaScript
app.get("/api/produse", lista());
Corect
JavaScript
app.get("/api/produse", lista);

Cu paranteze, Express primește ce întoarce lista(), nu funcția.

Repară tu

Repară eroarea, direct în pagină

Controllerul controllers/produse.js exportă funcțiile listaProduse și detaliiProdus, dar rutele din index.js folosesc alte nume, iar pornirea dă Error: Route.get() requires a callback function but got a [object Undefined] (în Express 5: argument handler must be a function). Folosește numele exportate, ca testul să afișeze lista și detaliile produsului 2.

Codul care dă eroarea
JavaScript
const express = require("express");
const produse = require("./controllers/produse");

const app = express();
app.get("/api/produse", produse.lista);
app.get("/api/produse/:id", produse.detalii);

const server = app.listen(3000, async () => {
  for (const url of ["/api/produse", "/api/produse/2"]) {
    const r = await fetch(`http://localhost:3000${url}`);
    console.log(`${url} -> ${JSON.stringify(await r.json())}`);
  }
  server.close();
});
După reparație, programul afișează
/api/produse -> ["Cafea","Ceai"]
/api/produse/2 -> {"id":2,"nume":"Ceai"}
Indiciu

Afișează require("./controllers/produse") ca să vezi numele exacte ale funcțiilor.

Alte forme ale mesajului

  • Error: Route.post() requires a callback function but got a [object Undefined]
  • Error: Route.get() requires a callback function but got a [object Object]
  • TypeError: argument handler must be a function

Cum o eviți pe viitor

  • Folosește completarea automată a editorului când accesezi funcții din controller.
  • Ține numele funcțiilor din controller identice cu cele din rute.
  • Când apare eroarea, afișează console.log(controller) ca să vezi ce exportă de fapt.
  • Evită ca fișierul de rute și controllerul să se ceară unul pe altul.

Întrebări frecvente

De ce eroarea apare la pornire, nu la cerere?

Express verifică handler-ele când definești ruta. Dacă unul nu e funcție, nu are ce apela la cereri, așa că oprește aplicația imediat.

Ce e [object Object] din varianta mesajului?

Ai dat un obiect în loc de funcție, de obicei tot controllerul (app.get("/", controller)) în loc de o funcție din el.

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.