Фреймворк Express для серверной разработки на Node.js

Расширенные примеры использования Express.js

Асинхронные функции в middleware и обработка ошибок

При работе с асинхронными операциями, такими как запросы к базе данных, необходимо корректно передавать ошибки в Express. Для этого используется обертка, которая возвращает middleware, вызывающий next при возникновении ошибки.

const asyncHandler = fn => (req, res, next) => {
  Promise.resolve(fn(req, res, next)).catch(next);
};

app.get('/data', asyncHandler(async (req, res) => {
  const result = await fetchSomeData();
  res.json(result);
}));

// Если fetchSomeData выбрасывает исключение, оно будет перехвачено и передано в next.
// Результат: при ошибке запроса возвращается статус 500 с сообщением ошибки (если определен middleware для обработки ошибок).

// Пример ответа при успехе: { "data": [...] }
// Пример ответа при ошибке: Статус 500, тело "Internal Server Error" (зависит от реализации error middleware)

Загрузка файлов с multer

Multer – middleware для обработки multipart/form-data. Позволяет сохранять загруженные файлы на диск или в память.

const multer = require('multer');
const upload = multer({ dest: 'uploads/' });

app.post('/upload', upload.single('file'), (req, res) => {
  const file = req.file;
  if (!file) {
    return res.status(400).send('Файл не загружен');
  }
  res.send(`Файл ${file.originalname} загружен, размер ${file.size} байт`);
});

// Для загрузки нескольких файлов используется upload.array('files', maxCount)

// При отправке POST запроса с файлом в поле "file" сервер возвращает сообщение о загрузке.
// Файл сохраняется в папку uploads с сгенерированным именем.
// Пример ответа: "Файл photo.jpg загружен, размер 12345 байт"

Вложенные роутеры и middleware на уровне роутера

Создание иерархии маршрутов с использованием options `mergeParams` для доступа к параметрам родительского роутера.

const parentRouter = express.Router();
const childRouter = express.Router({ mergeParams: true });

// Middleware, применяемый только к дочернему роутеру
childRouter.use((req, res, next) => {
  console.log(`Дочерний роутер, userId: ${req.params.userId}`);
  next();
});

childRouter.get('/', (req, res) => {
  res.send(`Список постов пользователя ${req.params.userId}`);
});

childRouter.get('/:postId', (req, res) => {
  res.send(`Пост ${req.params.postId} пользователя ${req.params.userId}`);
});

parentRouter.use('/users/:userId/posts', childRouter);

app.use('/api', parentRouter);

// GET /api/users/123/posts -> Список постов пользователя 123
// GET /api/users/123/posts/456 -> Пост 456 пользователя 123
// В консоли выводится: "Дочерний роутер, userId: 123"