TypeError: Cannot read properties of undefined (reading 'headers')
În Express, eroarea apare de obicei când apelezi un middleware la înregistrare, auth() în loc de auth, așa că funcția rulează imediat, fără cerere, iar req e undefined. Dă rutei funcția însăși: app.get("/api", auth, handler). Altă cauză: parametrii (req, res) inversați sau un handler apelat de mână.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
req.headers există în orice cerere Express sau http. Dacă req e undefined, înseamnă că funcția ta a fost apelată de altcineva decât Express, fără argumente.
Cel mai des se întâmplă la înregistrarea rutelor: app.get("/api/comenzi", auth(), handler). Parantezele de după auth apelează funcția în momentul pornirii serverului, fără cerere, iar prima linie care citește req.headers pică. Eroarea apare la pornire, înainte ca serverul să asculte, cu stiva arătând linia app.get.
Parantezele sunt corecte doar pentru „fabricile” de middleware, funcții care întorc un middleware: express.json(), cors(), rateLimit({ ... }), sau propriile tale cereRol("admin"). Middleware-urile obișnuite, scrise direct ca (req, res, next), se dau fără paranteze. Alte cauze: ai inversat parametrii ((res, req)), ai apelat handlerul în teste fără să-i dai un obiect req, sau citești this.req într-o funcție fără context.
De ce apare: cauzele frecvente
1Middleware apelat la înregistrare
app.get("/api/comenzi", auth(), (req, res) => res.json(comenzi));app.get("/api/comenzi", auth, (req, res) => res.json(comenzi));Express trebuie să primească funcția, ca s-o apeleze el la fiecare cerere, cu req, res și next.
2Ai nevoie de parametri: scrie o fabrică de middleware
function cereRol(req, res, next, rol) { /* ... */ }
app.get("/admin", cereRol("admin"), handler);function cereRol(rol) {
return (req, res, next) => {
if (req.user?.rol !== rol) return res.status(403).end();
next();
};
}
app.get("/admin", cereRol("admin"), handler);cereRol("admin") rulează la pornire și întoarce middleware-ul; acela primește cererea mai târziu.
3Parametri inversați
app.use((res, req, next) => {
console.log(req.headers["user-agent"]);
next();
});app.use((req, res, next) => {
console.log(req.headers["user-agent"]);
next();
});Ordinea e fixă: cererea, răspunsul, next. Cu numele inversate, „req” e de fapt răspunsul, care nu are headers cu datele cererii.
Repară eroarea, direct în pagină
Ruta /api/comenzi e protejată de middleware-ul auth, dar serverul nici nu pornește: TypeError: Cannot read properties of undefined (reading 'headers'). Repară înregistrarea rutei, ca cererea fără cheie să primească 401, iar cea cu cheia corectă să primească lista de comenzi.
const express = require("express");
const app = express();
function auth(req, res, next) {
if (req.headers["x-cheie"] !== "secret") {
return res.status(401).json({ eroare: "Neautorizat" });
}
next();
}
try {
app.get("/api/comenzi", auth(), (req, res) => res.json([{ id: 1042, total: 125 }]));
} catch (err) {
console.error(`Serverul nu a pornit: ${err.message}`);
process.exit(1);
}
const server = app.listen(3000, async () => {
const fara = await fetch("http://localhost:3000/api/comenzi");
console.log(`Fără cheie: ${fara.status}`);
const cu = await fetch("http://localhost:3000/api/comenzi", { headers: { "x-cheie": "secret" } });
console.log(`Cu cheie: ${cu.status} ${JSON.stringify(await cu.json())}`);
server.close();
});Fără cheie: 401
Cu cheie: 200 [{"id":1042,"total":125}]Indiciu
Uită-te la auth() din app.get: Express are nevoie de funcție, nu de rezultatul apelului ei.
Reparația
const express = require("express");
const app = express();
function auth(req, res, next) {
if (req.headers["x-cheie"] !== "secret") {
return res.status(401).json({ eroare: "Neautorizat" });
}
next();
}
try {
app.get("/api/comenzi", auth, (req, res) => res.json([{ id: 1042, total: 125 }]));
} catch (err) {
console.error(`Serverul nu a pornit: ${err.message}`);
process.exit(1);
}
const server = app.listen(3000, async () => {
const fara = await fetch("http://localhost:3000/api/comenzi");
console.log(`Fără cheie: ${fara.status}`);
const cu = await fetch("http://localhost:3000/api/comenzi", { headers: { "x-cheie": "secret" } });
console.log(`Cu cheie: ${cu.status} ${JSON.stringify(await cu.json())}`);
server.close();
});De ce merge
auth() apela middleware-ul chiar pe linia de înregistrare, fără nicio cerere, deci req era undefined, iar req.headers oprea programul înainte de listen. Fără paranteze, auth e dat lui Express ca funcție, iar Express îl apelează la fiecare cerere cu req, res și next: cererea fără header primește 401, cea cu x-cheie: secret ajunge la handler și primește comenzile.
Alte forme ale mesajului
TypeError: Cannot read properties of undefined (reading 'authorization')TypeError: Cannot read properties of undefined (reading 'body')TypeError: Cannot read property 'headers' of undefinedTypeError: Cannot read properties of undefined (reading 'user-agent')
Cum o eviți pe viitor
- Ține minte regula: middleware-ul se dă fără paranteze; fabricile de middleware (
express.json(),cors()) se apelează. - Când un middleware are nevoie de opțiuni, scrie-l ca fabrică, ca să fie clar unde se pun parantezele.
- Declară mereu parametrii în ordinea
(req, res, next).
Întrebări frecvente
De ce eroarea apare la pornire, nu la cerere?
Pentru că funcția e apelată chiar pe linia app.get(...), când se înregistrează ruta. Dacă ar fi fost dată fără paranteze, ar fi rulat doar la cereri, unde req există.
Și Route.get() requires a callback function but got a [object Undefined]?
E aceeași greșeală, dar cu un middleware care nu citește req la început: apelul auth() reușește și întoarce undefined, pe care Express îl refuză ca handler.
Erori înrudite
Error: Route.get() requires a callback function but got a [object Undefined] 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ă. ReferenceError: next is not defined Middleware-ul tău apelează next(), dar funcția nu are parametrul next: e declarată (req, res) în loc de (req, res, next). Adaugă al treilea parametru. Express dă next fiecărui middleware, dar doar dacă îl primești în lista de parametri. TypeError: Cannot destructure property 'nume' of 'req.body' as it is undefined. req.body este undefined pentru că Express nu citește singur corpul cererii: lipsește app.use(express.json()) (sau express.urlencoded() pentru formulare), e pus după rute, ori clientul nu trimite Content-Type: application/json. Adaugă middleware-ul înaintea rutelor. Î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.
