Middleware Express'te request-response döngüsü sırasında sırayla çalışan fonksiyonlardır. Her biri (req, res, next) alır ve request/response'u inceleyebilir/değiştirebilir, response'u sonlandırabilir veya kontrolü bir sonraki middleware'e geçmek için next() çağırabilir. Express uygulamalarının nasıl yapılandırıldığının temelini oluştururlar.
app.use((req, res, next) => {
console.log(`${req.method} ${req.url}`); // do something
next(); // ⬅ pass control to the next middleware
});
Kritik kural: zinciri devam ettirmek için next() çağırın. Bunu unutursanız (ve response göndermezseniz), request sonsuza dek bekler.
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, short-circuit edebilir (response gönderin ve next() çağırmayın, örneğin yetkisiz istekleri engelleme) veya request'i zenginleştirebilir (downstream handler'lar için req.user ekleme).
// 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
Bir hata handler'ında dört parametre vardır (err ilk). next(err) çağırarak buraya ulaşırsınız; son olarak kaydedilmelidir.
Middleware runs in the ORDER you register it. Body parser before routes that
read the body; auth before protected routes; error handler last.
Middleware Express'in (ve benzer framework'lerin) mimarisinin temelini oluşturur — kimlik doğrulama, logging, body parsing, CORS, doğrulama ve hata işleme hepsi middleware'dir.
(req, res, next) sözleşmesini anlamak (özellikle next() çağırmanız veya response göndermen gerektiğini), middleware'in request'leri nasıl short-circuit edebileceğini veya zenginleştirebileceğini, dört argümanlı hata handler'ını ve sıranın önemli olduğunu anlamak, her Express uygulaması oluşturmak, yapılandırmak ve hata ayıklamak için gereklidir.