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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
app.use(cale, middleware) primește o funcție (req, res, next) sau un router creat cu express.Router() (care este tot o funcție). Dacă primește un obiect obișnuit, Express 4 aruncă Router.use() requires a middleware function but got a Object; Express 5 dă TypeError: argument handler must be a function. Eroarea apare la pornire, înainte ca serverul să asculte.
Aproape mereu vine dintr-un require al unui fișier de rute care nu exportă ce crezi:
- fișierul nu are
module.exports = router, decirequireîntoarce{}; - fișierul exportă
module.exports = { router }, iar tu folosești direct obiectul; - ai importat un modul întreg în loc de o funcție din el (
app.use(require("./middleware"))când modulul exportă{ auth, log }).
Afișează valoarea cu console.log(require("./rute/produse")) ca să vezi ce primești.
De ce apare: cauzele frecvente
1Fișierul de rute nu exportă routerul
// rute/produse.js
const router = express.Router();
router.get("/", lista);// rute/produse.js
const router = express.Router();
router.get("/", lista);
module.exports = router;Fără export, require întoarce obiectul gol {}.
2Routerul e exportat într-un obiect
// module.exports = { router };
const rute = require("./rute/produse");
app.use("/api/produse", rute);const { router } = require("./rute/produse");
app.use("/api/produse", router);Când exportul e un obiect, iei routerul din el prin destructurare.
3Modul de middleware întreg
// middleware.js: module.exports = { auth, logger };
app.use(require("./middleware"));const { auth, logger } = require("./middleware");
app.use(logger);
app.use("/api", auth);app.use vrea o funcție, nu obiectul care conține funcțiile.
Repară eroarea, direct în pagină
Fișierul rute/produse.js exportă routerul într-un obiect, module.exports = { router }, iar index.js dă la pornire TypeError: Router.use() requires a middleware function but got a Object (în varianta Express 5: argument handler must be a function). Ia routerul corect din modul în index.js, ca testul să afișeze lista de produse.
const express = require("express");
const ruteProduse = require("./rute/produse");
const app = express();
app.use("/api/produse", ruteProduse);
const server = app.listen(3000, async () => {
const r = await fetch("http://localhost:3000/api/produse");
console.log(`Status: ${r.status}`);
console.log(await r.json());
server.close();
});Status: 200 [ 'Cafea', 'Ceai' ]
Indiciu
Când exportul e { router }, scrii const { router } = require("./rute/produse");.
Reparația
const express = require("express");
const { router: ruteProduse } = require("./rute/produse");
const app = express();
app.use("/api/produse", ruteProduse);
const server = app.listen(3000, async () => {
const r = await fetch("http://localhost:3000/api/produse");
console.log(`Status: ${r.status}`);
console.log(await r.json());
server.close();
});De ce merge
require("./rute/produse") întoarce exact valoarea lui module.exports, adică obiectul { router }, nu routerul. app.use acceptă doar funcții (un router Express este o funcție), așa că refuză obiectul încă de la pornire. Cu const { router: ruteProduse } = require(...) scoți routerul din obiect și îl redenumești, iar app.use("/api/produse", ruteProduse) îl montează. Cererea GET /api/produse ajunge astfel la ruta / din router.
Alte forme ale mesajului
TypeError: argument handler must be a functionTypeError: Router.use() requires a middleware function but got a undefinedTypeError: app.use() requires a middleware function
Cum o eviți pe viitor
- Termină fiecare fișier de rute cu
module.exports = router;(sauexport default router). - Folosește aceeași convenție de export în toate fișierele de rute.
- Când
app.usedă eroare, afișează valoarea pe care o primește. - Nu apela middleware-ul la înregistrare:
app.use(logger), nuapp.use(logger()), decât dacăloggere o fabrică ce întoarce middleware-ul (caexpress.json()).
Întrebări frecvente
De ce express.json() are paranteze și middleware-ul meu nu?
express.json este o funcție care creează un middleware, de aceea o apelezi. Middleware-ul tău scris ca function logger(req, res, next) este deja middleware-ul, deci îl dai fără paranteze.
Ce înseamnă got a undefined?
Ai dat lui app.use o valoare undefined: o variabilă necompletată sau o proprietate inexistentă din modulul importat.
Erori înrudite
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: calcule.totalCos is not a function Modulul nu exportă funcția pe care o apelezi, așa că require îți dă un obiect fără ea. Cauza clasică în Node: ai scris exports = { totalCos } în loc de module.exports = { totalCos }, ai uitat exportul sau numele diferă. Exportă cu module.exports. 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. Î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.
