...
Eroare Node.js · Express

TypeError: res.status is not a function

Pe scurt

Variabila res nu e obiectul răspuns Express: de obicei parametrii handler-ului sunt inversați ((res, req) în loc de (req, res)), handler-ul de erori are doar 3 parametri în loc de 4, sau folosești modulul http simplu, unde res nu are status() și json(). Verifică ordinea: (req, res, next) și (err, req, res, next).

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

Ce înseamnă

Express apelează fiecare handler cu argumentele într-o ordine fixă: (req, res, next) pentru rute și middleware, (err, req, res, next) pentru handler-ul de erori. Numele parametrilor nu contează, doar poziția. Dacă scrii (res, req), variabila numită res primește de fapt cererea, care nu are metoda status.

A doua capcană: un handler de erori recunoscut de Express trebuie să aibă exact 4 parametri. Cu (err, req, res) Express îl tratează ca middleware obișnuit, deci err e cererea, req e răspunsul, iar res e funcția next, care nu are status.

A treia: modulul http din Node. Acolo res e un ServerResponse simplu, cu statusCode, setHeader și end, dar fără status(), json() sau send(), care sunt adăugate de Express. La fel, res.json is not a function și res.send is not a function au aceleași cauze.

De ce apare: cauzele frecvente

1Parametri inversați

Greșit
JavaScript
app.get("/api/produse", (res, req) => {
  res.status(200).json(produse);
});
Corect
JavaScript
app.get("/api/produse", (req, res) => {
  res.status(200).json(produse);
});

Express dă întâi cererea, apoi răspunsul; ordinea parametrilor trebuie să fie aceeași.

2Handler de erori cu 3 parametri

Greșit
JavaScript
app.use((err, req, res) => {
  res.status(500).json({ eroare: err.message });
});
Corect
JavaScript
app.use((err, req, res, next) => {
  res.status(500).json({ eroare: err.message });
});

Express recunoaște handler-ul de erori după numărul de parametri. Al patrulea, next, trebuie declarat chiar dacă nu îl folosești.

3Modulul http fără Express

Greșit
JavaScript
http.createServer((req, res) => {
  res.status(200).json({ ok: true });
});
Corect
JavaScript
http.createServer((req, res) => {
  res.writeHead(200, { "Content-Type": "application/json" });
  res.end(JSON.stringify({ ok: true }));
});

status și json există doar în Express. Cu http simplu folosești writeHead și end.

Repară tu

Repară eroarea, direct în pagină

Ruta /api/produse are parametrii handler-ului în ordinea greșită, (res, req), așa că Express răspunde cu 500, iar în consolă apare TypeError: res.status is not a function. Repară ordinea parametrilor, ca testul să primească lista de produse cu statusul 200.

Codul care dă eroarea
JavaScript
const express = require("express");

const app = express();
const produse = [{ nume: "Cafea", pret: 42 }, { nume: "Ceai", pret: 18 }];

app.get("/api/produse", (res, req) => {
  res.status(200).json(produse);
});

app.use((err, req, res, next) => {
  console.error(`Eroare: ${err.message}`);
  res.status(err.status || 500).json({ eroare: err.message });
});

const server = app.listen(3000, async () => {
  const r = await fetch("http://localhost:3000/api/produse");
  console.log(`Status: ${r.status}`);
  if (!r.ok) process.exitCode = 1;
  else for (const p of await r.json()) console.log(`- ${p.nume}: ${p.pret} lei`);
  server.close();
});
După reparație, programul afișează
Status: 200
- Cafea: 42 lei
- Ceai: 18 lei
Indiciu

Express apelează handler-ul cu cererea pe primul loc și răspunsul pe al doilea.

Alte forme ale mesajului

  • TypeError: res.json is not a function
  • TypeError: res.send is not a function
  • TypeError: res.status(...).json is not a function
  • TypeError: res.sendStatus is not a function

Cum o eviți pe viitor

  • Scrie mereu semnăturile la fel: (req, res, next) și (err, req, res, next).
  • Pune handler-ul de erori cu 4 parametri chiar dacă next rămâne nefolosit (un linter îți poate cere să-l prefixezi: _next).
  • Nu amesteca exemplele scrise pentru http cu cele pentru Express.
  • Cu TypeScript sau JSDoc (@param {import("express").Response} res), editorul îți arată imediat metodele disponibile.

Întrebări frecvente

De ce clientul primește 500 Internal Server Error?

Eroarea apare în interiorul handler-ului, iar Express o prinde și răspunde cu 500. Mesajul complet, cu linia, îl vezi în consola serverului.

Și res.status(...).json is not a function?

res era corect, dar status a fost suprascris sau ai un obiect res fals (de exemplu un mock în teste) care nu întoarce this din status(). În Express real, status() întoarce răspunsul, ca să poți înlănțui .json().

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.