...
Eroare Node.js · Express

TypeError: Router.use() requires a middleware function but got a Object

Pe scurt

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, deci require î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

Greșit
JavaScript
// rute/produse.js
const router = express.Router();
router.get("/", lista);
Corect
JavaScript
// 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

Greșit
JavaScript
// module.exports = { router };
const rute = require("./rute/produse");
app.use("/api/produse", rute);
Corect
JavaScript
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

Greșit
JavaScript
// middleware.js: module.exports = { auth, logger };
app.use(require("./middleware"));
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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();
});
După reparație, programul afișează
Status: 200
[ 'Cafea', 'Ceai' ]
Indiciu

Când exportul e { router }, scrii const { router } = require("./rute/produse");.

Alte forme ale mesajului

  • TypeError: argument handler must be a function
  • TypeError: Router.use() requires a middleware function but got a undefined
  • TypeError: app.use() requires a middleware function

Cum o eviți pe viitor

  • Termină fiecare fișier de rute cu module.exports = router; (sau export default router).
  • Folosește aceeași convenție de export în toate fișierele de rute.
  • Când app.use dă eroare, afișează valoarea pe care o primește.
  • Nu apela middleware-ul la înregistrare: app.use(logger), nu app.use(logger()), decât dacă logger e o fabrică ce întoarce middleware-ul (ca express.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

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