Урок 022 минуты чтения
Как HTTP-запрос проходит через Express?
На этой странице
Кратко
Express последовательно передаёт запрос через промежуточные обработчики, затем запускает подходящий маршрут и отправляет сформированный ответ клиенту.
Вопрос
Как HTTP-запрос проходит через Express-приложение? Почему важен порядок регистрации обработчиков?
Общая схема
Клиент
↓
HTTP-сервер Node.js
↓
express.json()
↓
CORS, журнал, авторизация
↓
маршрутизатор
↓
обработчик маршрута
↓
служба и база данных
↓
JSON-ответПример цепочки
import express from "express";
const app = express();
app.use(express.json());
app.use((request, response, next) => {
console.log(request.method, request.url);
next();
});
app.post("/api/users", (request, response) => {
response.status(201).json({
id: 1,
name: request.body.name,
});
});Для POST /api/users произойдёт следующее:
express.json()прочитает JSON и запишет его вrequest.body.- Следующая функция выведет метод и адрес.
next()передаст управление дальше.- Express найдёт подходящий маршрут.
- Маршрут сформирует ответ с кодом
201.
Почему важен порядок
Express выполняет обработчики сверху вниз.
// Правильно: JSON разбирается до маршрута.
app.use(express.json());
app.post("/api/users", createUser);// Неправильно: маршрут ещё не получил разобранное тело.
app.post("/api/users", createUser);
app.use(express.json());Обработчик ошибки и маршрут 404 обычно размещают в самом конце.
Запрос должен завершиться
Каждый путь выполнения должен сделать одно из двух:
- отправить ответ;
- вызвать
next()и передать управление дальше.
app.use((request, response, next) => {
if (!request.headers.authorization) {
response.status(401).json({ message: "Требуется авторизация" });
return;
}
next();
});Если не отправить ответ и не вызвать next(), запрос зависнет.
Что важно помнить
- Express вызывает функции строго в порядке
app.use()и объявления маршрутов. - Каждая ветка обработчика должна либо отправить ответ, либо вызвать
next()— иначе запрос зависнет. express.json()регистрируется до маршрутов, иначеrequest.bodyбудет пустым.- Маршрут
404и обработчик ошибок подключаются последними.
Мини-шпаргалка
- Express обрабатывает функции по порядку регистрации.
next()передаёт запрос следующей функции.- Маршрут обычно завершает запрос ответом.
- Общие обработчики регистрируются до маршрутов.
404и обработчик ошибок размещаются после маршрутов.
Документация
Express: Using middleware, Express: Writing middleware, Express: Routing.
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.