Що таке middleware?

Повне пояснення

Що це і навіщо Middleware — проміжний шар у обробці HTTP‑запитів. Він дозволяє виконувати повторювані задачі (логування, аутентифікація, парсинг JSON, CORS) перед досягненням кінцевого маршруту.

Ключові принципи

• Підпис: (req, res, next) або async (req, res, next).
• Переходить до наступного middleware через виклик next() або повертає відповідь.
• Може бути глобальним (app.use) або прив’язаним до конкретного маршруту.

Як це працює

1. Запит надходить до роутера.
2. Express/ NestJS виконує middleware у порядку реєстрації.
3. Кожен middleware може змінювати req/res, виконувати асинхронні операції, або завершити цикл.
4. Якщо next() не викликано, обробка зупиняється.

Практика і реалізація (Node.js / Express)

// логування
app.use((req, res, next) => {
  console.log(`${req.method} ${req.url}`);
  next();
});

// аутентифікація
app.use('/api', (req, res, next) => {
  if (!req.headers.authorization) return res.status(401).end();
  next();
});

Тестування (Jest + supertest)

const request = require('supertest');
const app = require('./app');

test('unauthenticated request', async () => {
  const res = await request(app).get('/api/secret');
  expect(res.statusCode).toBe(401);
});

Безпека

• Перевірка заголовків, токенів.
• Обмеження кількості запитів (rate‑limiting).
• CORS‑middleware.

Особливості в контексті NestJS

• Middleware реалізується як клас, що імплементує NestMiddleware.
• Додається через configure(consumer: MiddlewareConsumer).

Оптимізація

• Уникайте зайвих async/await у middleware, що не потребують асинхронності.
• Використовуйте next('route') для пропуску до наступного маршруту.

Часті помилки

1. Забутий next() → блокування.
2. Синхронний код, що блокує event‑loop → затримки.
3. Неправильний порядок middleware → неправильна логіка.
4. Перевантаження глобальним middleware → збільшена латентність.
5. Необроблені помилки в async‑middleware → 500‑статус.
6. Відсутність CORS у API, що викликається з браузера → 403.
7. Неправильне використання app.use('/path', middleware) → не застосовується до підшляху.
8. Перевірка токену без try/catch → сервер падає.

Cheatsheet

• app.use(middleware) – глобально.
• router.use(path, middleware) – прив’язано до шляху.
• next() – продовжити.
• next('route') – пропустити до наступного маршруту.
• app.use(errorHandler) – глобальний error‑handler (параметри: err, req, res, next).