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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În Express, req.body este completat de un middleware de parsare: express.json() pentru corpuri JSON și express.urlencoded({ extended: true }) pentru formulare HTML. Fără el, req.body rămâne undefined și orice destructurare const { nume } = req.body aruncă această eroare. Express prinde eroarea, o afișează în consolă și răspunde clientului cu 500.
Alte cauze: middleware-ul e înregistrat după rute (Express le aplică în ordine), clientul trimite JSON fără headerul Content-Type: application/json (atunci express.json() nu-l citește: în Express 5 req.body rămâne undefined, iar în Express 4 devine {}), sau trimiți datele în query string și le cauți în body.
Linia din stivă care pornește din fișierul tău îți arată ruta cu problema; afișează req.headers["content-type"] și req.body acolo ca să vezi ce ajunge la server.
De ce apare: cauzele frecvente
1Lipsește express.json()
const app = express();
app.post("/api/utilizatori", (req, res) => {
const { nume } = req.body;
});const app = express();
app.use(express.json());
app.post("/api/utilizatori", (req, res) => {
const { nume } = req.body;
});express.json() citește corpul cererii și pune obiectul rezultat în req.body.
2Middleware-ul e după rute
app.post("/api/utilizatori", creeaza);
app.use(express.json());app.use(express.json());
app.post("/api/utilizatori", creeaza);Express trece cererea prin middleware-uri și rute în ordinea înregistrării.
3Clientul nu trimite Content-Type
fetch(url, { method: "POST", body: JSON.stringify(date) });fetch(url, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(date),
});express.json() parsează doar cererile cu tipul application/json.
4Formular HTML
app.use(express.json());
// <form method="POST"> trimite application/x-www-form-urlencodedapp.use(express.urlencoded({ extended: true }));Formularele obișnuite trimit datele codificate ca URL, nu ca JSON.
Repară eroarea, direct în pagină
Ruta POST /api/utilizatori destructurează req.body, dar serverul nu citește corpul JSON al cererii și handler-ul de erori răspunde 500 cu mesajul Cannot destructure property 'nume' of 'req.body' as it is undefined., iar testul pică. Adaugă middleware-ul care parsează JSON, ca testul să afișeze utilizatorul creat.
const express = require("express");
const app = express();
app.post("/api/utilizatori", (req, res) => {
const { nume, email } = req.body;
if (!nume || !email) return res.status(400).json({ eroare: "Lipsesc câmpuri" });
res.status(201).json({ id: 1, nume, email });
});
app.use((err, req, res, next) => {
res.status(500).json({ eroare: err.message });
});
const server = app.listen(3000, async () => {
const r = await fetch("http://localhost:3000/api/utilizatori", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ nume: "Ana", email: "ana@exemplu.ro" }),
});
console.log(`Status: ${r.status}`);
console.log(await r.json());
if (!r.ok) process.exitCode = 1; // testul a picat
server.close();
});Status: 201
{ id: 1, nume: 'Ana', email: 'ana@exemplu.ro' }Indiciu
app.use(express.json()); trebuie pus înaintea rutelor.
Reparația
const express = require("express");
const app = express();
app.use(express.json());
app.post("/api/utilizatori", (req, res) => {
const { nume, email } = req.body;
if (!nume || !email) return res.status(400).json({ eroare: "Lipsesc câmpuri" });
res.status(201).json({ id: 1, nume, email });
});
app.use((err, req, res, next) => {
res.status(500).json({ eroare: err.message });
});
const server = app.listen(3000, async () => {
const r = await fetch("http://localhost:3000/api/utilizatori", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ nume: "Ana", email: "ana@exemplu.ro" }),
});
console.log(`Status: ${r.status}`);
console.log(await r.json());
if (!r.ok) process.exitCode = 1; // testul a picat
server.close();
});De ce merge
Corpul unei cereri POST ajunge la server ca un șir de octeți, iar Express nu îl interpretează singur. express.json() citește corpul cererilor cu Content-Type: application/json, face JSON.parse și pune obiectul în req.body. Fără el, req.body e undefined, destructurarea aruncă, handler-ul de erori răspunde 500 cu mesajul excepției, iar testul marchează eșecul cu process.exitCode = 1. Înregistrat înaintea rutei, middleware-ul pregătește req.body, deci ruta primește nume și email și răspunde 201.
Alte forme ale mesajului
TypeError: Cannot read properties of undefined (reading 'nume')TypeError: Cannot destructure property 'email' of 'req.body' as it is undefined.TypeError: Cannot convert undefined or null to object
Cum o eviți pe viitor
- Pune
app.use(express.json())imediat dupăconst app = express(), înaintea tuturor rutelor. - Trimite mereu
Content-Type: application/jsondin client când trimiți JSON. - Validează corpul cererii la începutul rutei și răspunde 400 dacă lipsesc câmpuri.
- Folosește
const { nume } = req.body ?? {}doar ca protecție, nu în locul parserului.
Întrebări frecvente
Mai am nevoie de body-parser?
Nu. De la Express 4.16, express.json() și express.urlencoded() sunt incluse; body-parser separat e necesar doar în proiecte foarte vechi.
Am pus express.json(), dar câmpurile sunt tot undefined. De ce?
Cel mai probabil clientul nu trimite headerul Content-Type: application/json, așa că parserul ignoră corpul. În Express 4 req.body devine atunci {}, deci destructurarea merge, dar câmpurile lipsesc; în Express 5 rămâne undefined și primești chiar această eroare.
Erori înrudite
Cannot GET /api/produs Express nu are nicio rută care să se potrivească cu metoda și calea cererii, așa că răspunde 404 cu Cannot GET /cale. Verifică litera cu literă calea din client și din app.get, metoda (GET vs POST), prefixul din app.use("/api", router) și ordinea în care sunt înregistrate rutele. Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client Încerci să trimiți al doilea răspuns la aceeași cerere: după res.end, res.send sau res.json ai mai apelat res.json, res.status sau res.setHeader. De obicei lipsește un return după răspunsul de eroare. Scrie return res.status(404).json(...). TypeError: Router.use() requires a middleware function but got a Object Ai dat lui app.use sau router.use un obiect în loc de o funcție middleware sau de un router. Cel mai des, fișierul cu rute exportă { router } sau nu exportă nimic (module.exports lipsește). Exportă routerul cu module.exports = router și folosește-l așa cum e exportat. Î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.
