...
Eroare Node.js · Express

TypeError: Cannot destructure property 'nume' of 'req.body' as it is undefined.

Pe scurt

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

Greșit
JavaScript
const app = express();
app.post("/api/utilizatori", (req, res) => {
  const { nume } = req.body;
});
Corect
JavaScript
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

Greșit
JavaScript
app.post("/api/utilizatori", creeaza);
app.use(express.json());
Corect
JavaScript
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

Greșit
JavaScript
fetch(url, { method: "POST", body: JSON.stringify(date) });
Corect
JavaScript
fetch(url, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(date),
});

express.json() parsează doar cererile cu tipul application/json.

4Formular HTML

Greșit
JavaScript
app.use(express.json());
// <form method="POST"> trimite application/x-www-form-urlencoded
Corect
JavaScript
app.use(express.urlencoded({ extended: true }));

Formularele obișnuite trimit datele codificate ca URL, nu ca JSON.

Repară tu

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.

Codul care dă eroarea
JavaScript
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();
});
După reparație, programul afișează
Status: 201
{ id: 1, nume: 'Ana', email: 'ana@exemplu.ro' }
Indiciu

app.use(express.json()); trebuie pus înaintea rutelor.

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/json din 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

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