Middleware ovat funktioita, jotka suoritetaan peräkkäin Express-sovelluksen pyyntö-vastaus-syklin aikana. Jokainen saa (req, res, next) ja voi tarkastaa/muokata pyyntöä ja vastausta, päättää vastauksen tai kutsua next() siirtääkseen kontrollin seuraavalle middlewarelle. Ne muodostavat Express-sovelluksien rakenteen ytimen.
app.use((req, res, next) => {
console.log(`${req.method} ${req.url}`); // do something
next(); // ⬅ pass control to the next middleware
});
Kriittinen sääntö: kutsua next() jatkaaksesi ketjua. Jos unohdat sen (eikä lähetä vastausta), pyyntö jää jumiin ikuisesti.
Request → [logger] → [auth] → [body parser] → [route handler] → Response
next() next() next() res.send()
Each middleware runs in order; any can short-circuit by sending a response.
// 1. Application-level — runs for all (or path-matched) requests
app.use(express.json()); // built-in: parse JSON bodies
app.use(cors()); // third-party
// 2. Custom — e.g. authentication that can SHORT-CIRCUIT
function requireAuth(req, res, next) {
if (!req.headers.authorization) {
return res.status(401).json({ error: "Unauthorized" }); // STOP — don't call next()
}
req.user = decodeToken(req.headers.authorization); // attach data for later handlers
next(); // authorized → continue
}
// 3. Route-specific
app.get("/profile", requireAuth, (req, res) => res.json(req.user));
Middleware voi katkaista piirin (lähettää vastauksen eikä kutsua next(), esim. estää valtuuttamattomia pyyntöjä) tai rikastaa pyyntöä (liittää req.user loppupään käsittelijöille).
// special signature with 4 params → Express treats it as an error handler
app.use((err, req, res, next) => {
console.error(err);
res.status(500).json({ error: "Server error" });
});
// triggered by next(err) or a thrown error; place it LAST
Virheenkäsittelijällä on neljä parametria (err ensin). Siihen pääsee kutsumalla next(err); se tulee rekisteröidä viimeisenä.
Middleware runs in the ORDER you register it. Body parser before routes that
read the body; auth before protected routes; error handler last.
Middleware on Express-sovelluksen (ja vastaavien kehysten) arkkitehtoninen selkäranka — autentikointi, lokitus, runkoparsinta, CORS, validointi ja virheenkäsittely ovat kaikki middleware.
Ymmärtäminen (req, res, next) sopimuksesta (erityisesti että sinun on kutsuttava next() tai lähetettävä vastaus), kuinka middleware voi katkaista piirin tai rikastaa pyyntöjä, neljän argumentin virheenkäsittelijä ja että järjestyksellä on merkitystä, on välttämätöntä minkä tahansa Express-sovelluksen rakentamiseen, rakenteeseen ja virheenkorjaukseen.