...
Eroare Node.js · Express

TypeError: Cannot read properties of undefined (reading 'headers')

Pe scurt

Î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

Greșit
JavaScript
app.get("/api/comenzi", auth(), (req, res) => res.json(comenzi));
Corect
JavaScript
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

Greșit
JavaScript
function cereRol(req, res, next, rol) { /* ... */ }
app.get("/admin", cereRol("admin"), handler);
Corect
JavaScript
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

Greșit
JavaScript
app.use((res, req, next) => {
  console.log(req.headers["user-agent"]);
  next();
});
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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();
});
După reparație, programul afișează
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.

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 undefined
  • TypeError: 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

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