У Express.js можна створювати власні функції проміжного програмного забезпечення (middleware) за допомогою методу app.use(). Такі функції приймають три параметри: req (об'єкт запиту), res (об'єкт відповіді) та next (функція для передачі керування наступному проміжному програмному забезпеченню в ланцюжку). Власне middleware можна застосовувати глобально до всіх маршрутів або до окремих маршрутів, вказавши шлях маршруту.

Створення власного middleware

Ось базовий приклад власної функції middleware, яка фіксує мітку часу та URL кожного вхідного запиту:

app.use((req, res, next) => {
  const timestamp = new Date().toISOString();
  const url = req.url;
  
  console.log(`[${timestamp}] ${url}`);
  
  next(); // Pass control to the next middleware.
});

У цьому прикладі власне middleware виводить у консоль мітку часу та URL кожного вхідного запиту. Виклик функції next() передає керування наступному middleware у конвеєрі.

Приклад із практики: поєднання вбудованого та власного middleware

Ось практичний приклад, де використовується вбудоване middleware Express для розбору JSON-даних, а потім створюється власне middleware для валідації цих даних перед подальшою обробкою:

const express = require('express');
const app = express();

// Use built-in middleware to parse JSON data.
app.use(express.json());

// Custom middleware to validate JSON data.
app.use((req, res, next) => {
  const jsonData = req.body;

  if (!jsonData || Object.keys(jsonData).length === 0) {
    // If the JSON data is missing or empty, send an error response.
    return res.status(400).json({ error: 'Invalid JSON data' });
  }

  // Data is valid; proceed to the next middleware or route.
  next();
});

// Route that expects valid JSON data.
app.post('/api/data', (req, res) => {
  const jsonData = req.body;
  res.status(200).json({ message: 'Data received', data: jsonData });
});

app.listen(3000, () => {
  console.log('Server is running on port 3000.');
});

У цьому прикладі:

• Використовується вбудоване middleware express.json() для розбору вхідних JSON-даних;
• Створюється власне middleware, яке перевіряє, чи розібрані JSON-дані відсутні або порожні. Якщо так, надсилається відповідь 400 Bad Request з повідомленням про помилку. Якщо дані валідні, викликається next() для переходу до маршруту;
• Маршрут /api/data очікує валідні JSON-дані. Якщо власне middleware валідує дані, обробник маршруту їх отримує та надсилає відповідь про успішне отримання.

Цей приклад демонструє, як можна використовувати як вбудовані, так і власні проміжні обробники для перевірки даних перед передачею їх до обробників маршрутів, щоб переконатися, що дані мають очікуваний формат перед подальшою обробкою.