Урок 012 минуты чтения
Что содержат request и response?
На этой странице
Кратко
request описывает входящий HTTP-запрос, а response предоставляет методы для формирования ответа. Часто используются короткие имена req и res.
Вопрос
Какие данные содержит объект request и какие методы есть у response? Почему на запрос отправляется только один ответ?
Основные данные запроса
app.post("/api/users/:id", (request, response) => {
console.log(request.method);
console.log(request.path);
console.log(request.params);
console.log(request.query);
console.log(request.body);
console.log(request.headers.authorization);
response.json({ ok: true });
});| Свойство | Что содержит |
|---|---|
request.method | HTTP-метод |
request.path | Путь без строки запроса |
request.params | Параметры пути |
request.query | Параметры после ? |
request.body | Тело, разобранное промежуточным обработчиком |
request.headers | Заголовки |
request.ip | Адрес клиента с учётом настроек прокси |
Основные методы ответа
response.status(201).json({ id: 42 });| Метод | Назначение |
|---|---|
status(code) | Установить код ответа |
json(value) | Отправить JSON |
send(value) | Отправить строку, буфер или другое значение |
set(name, value) | Установить заголовок |
location(url) | Установить заголовок Location |
redirect(url) | Отправить перенаправление |
end() | Завершить ответ без тела |
Один ответ на один запрос
После отправки ответа функция должна завершиться:
app.get("/api/users/:id", (request, response) => {
const user = undefined;
if (!user) {
response.status(404).json({ message: "Пользователь не найден" });
return;
}
response.json(user);
});Без return код может попытаться отправить второй ответ и вызвать ошибку:
Cannot set headers after they are sentДанные запроса нельзя считать безопасными
Типы TypeScript не проверяют данные, которые пришли по сети. Клиент может прислать строку вместо числа, пропустить поле или отправить лишний объект.
// request.body имеет данные из внешнего мира.
const input = createUserSchema.parse(request.body);Что важно помнить
params,query,bodyи заголовки приходят от клиента и не проверены — типы TypeScript их не защищают.request.ipзависит от настройкиtrust proxy, если приложение стоит за обратным прокси.- После
response.json()в ветке условия нуженreturn, иначе возможна ошибкаCannot set headers after they are sent. - Короткие имена
reqиres— то же самое, это вопрос соглашения в команде.
Мини-шпаргалка
requestсодержит входные данные.responseформирует HTTP-ответ.- После
response.json()илиresponse.send()обычно нуженreturn. - На один запрос отправляется только один ответ.
params,query,bodyи заголовки нужно проверять.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.