TypeError: res.status is not a function
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
app.get("/api/produse", (res, req) => {
res.status(200).json(produse);
});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
app.use((err, req, res) => {
res.status(500).json({ eroare: err.message });
});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
http.createServer((req, res) => {
res.status(200).json({ ok: true });
});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ă 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.
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();
});Status: 200 - Cafea: 42 lei - Ceai: 18 lei
Indiciu
Express apelează handler-ul cu cererea pe primul loc și răspunsul pe al doilea.
Reparația
const express = require("express");
const app = express();
const produse = [{ nume: "Cafea", pret: 42 }, { nume: "Ceai", pret: 18 }];
app.get("/api/produse", (req, res) => {
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();
});De ce merge
Express trimite argumentele după poziție: primul e cererea, al doilea răspunsul. Cu (res, req), variabila res conținea cererea, care nu are status(), iar eroarea din handler devenea un răspuns 500. Cu (req, res), res e obiectul răspuns Express, cu status() și json(), iar clientul primește lista.
Alte forme ale mesajului
TypeError: res.json is not a functionTypeError: res.send is not a functionTypeError: res.status(...).json is not a functionTypeError: 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ă
nextrămâne nefolosit (un linter îți poate cere să-l prefixezi:_next). - Nu amesteca exemplele scrise pentru
httpcu 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
Internal Server Error Codul unei rute a aruncat o eroare netratată, iar Express a răspuns cu 500 și pagina „Internal Server Error”. Cauza reală e în consola serverului, cu stiva de apeluri. Repară eroarea de acolo (de obicei o valoare lipsă) și răspunde explicit cu 400 sau 404 pentru situațiile așteptate. 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ă. 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.
