re:re:actable
Урок 042 минуты чтения

Что такое middleware в Node.js-фреймворках?

На этой странице
Кратко

Middleware - это промежуточная функция, которая выполняется между получением запроса и отправкой ответа. Она может логировать запрос, проверять авторизацию, парсить body, добавлять данные в req или завершать ответ.

Вопрос

Что такое middleware в Node.js-фреймворках и как устроена цепочка обработки запроса?

Идея middleware

В веб-фреймворках запрос проходит через цепочку функций.

request -> middleware -> middleware -> route handler -> response

Каждая middleware может:

  • пропустить запрос дальше;
  • изменить req или res;
  • завершить ответ;
  • передать ошибку в обработчик ошибок.

Пример на Express

import express from 'express';
 
const app = express();
 
app.use((req, res, next) => {
  console.log(req.method, req.url);
  next();
});
 
app.get('/profile', (req, res) => {
  res.json({ name: 'Анна' });
});
 
app.listen(3000);

next() передает управление следующей middleware или маршруту.

Middleware авторизации

function requireAuth(req, res, next) {
  const token = req.headers.authorization;
 
  if (!token) {
    res.status(401).json({ message: 'Token required' });
    return;
  }
 
  next();
}
 
app.get('/admin', requireAuth, (req, res) => {
  res.json({ ok: true });
});

Ошибочная middleware

В Express middleware обработки ошибок имеет четыре аргумента:

app.use((error, req, res, next) => {
  console.error(error);
  res.status(500).json({ message: 'Internal server error' });
});

Что важно помнить

  • Middleware — функция (req, res, next), которая обрабатывает запрос или передает его дальше.
  • Порядок подключения важен: логирование и парсинг body — раньше маршрутов.
  • Забытый next() или ответ «вешает» запрос.
  • Обработчик ошибок в Express имеет четыре аргумента (err, req, res, next) и подключается последним.

Мини-шпаргалка

  • Middleware - функция между запросом и ответом.
  • next() передает управление дальше.
  • Middleware удобны для логов, авторизации, CORS, body parsing.
  • Middleware может завершить ответ сама.
  • Порядок регистрации middleware важен.

Документация

Express: Using middleware, Express: Error handling.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам