ReferenceError: next is not defined
Middleware-ul tău apelează next(), dar funcția nu are parametrul next: e declarată (req, res) în loc de (req, res, next). Adaugă al treilea parametru. Express dă next fiecărui middleware, dar doar dacă îl primești în lista de parametri.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un middleware Express e o funcție (req, res, next). next e funcția prin care spui „am terminat, treci la următorul handler”. Nu e o variabilă globală: există doar ca parametru, deci dacă l-ai omis din declarație, apelul next() dă ReferenceError: next is not defined.
Eroarea apare la prima cerere care trece prin middleware, nu la pornirea serverului. Express o prinde și răspunde cu 500 Internal Server Error, iar în consolă vezi stiva cu linia din middleware-ul tău. Clientul vede doar 500, fără motiv.
Situații tipice: un middleware de logare sau de autentificare scris rapid ca (req, res) => { ...; next(); }, un handler mutat dintr-o rută (unde nu avea nevoie de next) într-un app.use, sau un middleware de erori scris cu 3 parametri în loc de 4.
De ce apare: cauzele frecvente
1Parametrul next lipsește
function logCereri(req, res) {
console.log(`${req.method} ${req.url}`);
next();
}function logCereri(req, res, next) {
console.log(`${req.method} ${req.url}`);
next();
}Express trimite next ca al treilea argument; trebuie doar să îl primești în declarație.
2Middleware de erori cu parametrii greșiți
app.use((err, req, res) => {
if (err.status === 404) return res.status(404).json({ eroare: err.message });
next(err);
});app.use((err, req, res, next) => {
if (err.status === 404) return res.status(404).json({ eroare: err.message });
next(err);
});Un middleware de erori are exact 4 parametri; doar așa îl recunoaște Express, iar next e al patrulea.
3next folosit într-o funcție ajutătoare
function verificaToken(req) {
if (!req.headers.authorization) return next(new Error("Fără token"));
}function auth(req, res, next) {
if (!req.headers.authorization) return next(new Error("Fără token"));
next();
}next există doar în middleware-ul apelat de Express. O funcție ajutătoare trebuie să-l primească ca parametru sau să întoarcă un rezultat, pe care middleware-ul îl tratează.
Repară eroarea, direct în pagină
Serverul are un middleware care afișează fiecare cerere, dar orice cerere primește 500, iar în consolă apare ReferenceError: next is not defined. Repară middleware-ul logCereri, ca cererea să ajungă la rută și programul să afișeze statusul 200 și lista de produse.
const express = require("express");
const app = express();
function logCereri(req, res) {
console.log(`${req.method} ${req.url}`);
next();
}
app.use(logCereri);
app.get("/api/produse", (req, res) => res.json(["Cafea", "Ceai"]));
app.use((err, req, res, next) => {
console.error(`Eroare: ${err.message}`);
res.status(500).json({ eroare: "Eroare internă" });
});
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 console.log((await r.json()).join(", "));
server.close();
});GET /api/produse Status: 200 Cafea, Ceai
Indiciu
Funcția trebuie să primească next ca al treilea parametru.
Reparația
const express = require("express");
const app = express();
function logCereri(req, res, next) {
console.log(`${req.method} ${req.url}`);
next();
}
app.use(logCereri);
app.get("/api/produse", (req, res) => res.json(["Cafea", "Ceai"]));
app.use((err, req, res, next) => {
console.error(`Eroare: ${err.message}`);
res.status(500).json({ eroare: "Eroare internă" });
});
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 console.log((await r.json()).join(", "));
server.close();
});De ce merge
Express apelează fiecare middleware cu trei argumente: cererea, răspunsul și funcția next. Declarată cu doar doi parametri, funcția nu avea niciun nume next, iar apelul arunca ReferenceError, pe care Express îl transforma în 500. Cu (req, res, next), apelul trece controlul mai departe, la ruta /api/produse, care răspunde cu lista.
Alte forme ale mesajului
ReferenceError: next is not defined at logCereri (/app/index.js:5:3) at Layer.handle [as handle_request] (/app/node_modules/express/lib/router/layer.js:95:5)TypeError: next is not a functionReferenceError: req is not defined
Cum o eviți pe viitor
- Declară toate middleware-urile cu trei parametri,
(req, res, next), chiar dacă unele ramuri nu apeleazănext. - Middleware-urile de erori au mereu patru:
(err, req, res, next). - Testează fiecare middleware nou cu o cerere reală (sau cu
supertest), ca să vezi eroarea înainte de producție.
Întrebări frecvente
De ce serverul pornește fără eroare?
Funcția e doar înregistrată la pornire, nu și rulată. next e căutat abia când middleware-ul rulează, adică la prima cerere.
Și TypeError: next is not a function?
Apare când parametrul există, dar nu e funcția lui Express: de obicei ai apelat middleware-ul tu, direct, cu mai puține argumente, sau parametrii unui handler de erori sunt în altă ordine.
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. TypeError: Cannot read properties of undefined (reading 'headers') Î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ă. 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). Î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.
