request и response в node-http - headers, statusCode и body
На этой странице
request - объект входящего HTTP-запроса, а response - объект ответа, который сервер отправит клиенту. В Node.js они обычно называются req и res.
HTTP-ответ состоит из статус-кода, заголовков и тела. В Node.js статус задается через res.statusCode или writeHead, заголовки через setHeader, а тело отправляется через write и end.
Вопрос
Что такое request и response в node:http и как работать со статусом, заголовками и телом?
request
req содержит информацию о запросе:
| Свойство | Что означает |
|---|---|
req.method | HTTP-метод: GET, POST, PUT, DELETE |
req.url | Путь и query string |
req.headers | Заголовки запроса |
req.socket | Сетевое соединение |
import http from 'node:http';
http.createServer((req, res) => {
console.log(req.method);
console.log(req.url);
console.log(req.headers['user-agent']);
res.end('ok');
}).listen(3000);response
res нужен, чтобы сформировать ответ:
res.statusCode = 201;
res.setHeader('Content-Type', 'application/json');
res.end(JSON.stringify({ id: 1 }));Можно отправить статус и заголовки сразу:
res.writeHead(404, {
'Content-Type': 'application/json',
});
res.end(JSON.stringify({ message: 'Not found' }));Тело запроса
req является readable stream. Поэтому тело POST-запроса приходит частями.
async function readBody(req) {
const chunks = [];
for await (const chunk of req) {
chunks.push(chunk);
}
return Buffer.concat(chunks).toString('utf8');
}Статус-код
Статус-код сообщает результат запроса:
| Код | Значение |
|---|---|
200 | Успешно |
201 | Создано |
204 | Успешно, но без тела |
400 | Ошибка клиента |
401 | Не авторизован |
403 | Запрещено |
404 | Не найдено |
500 | Ошибка сервера |
res.statusCode = 404;
res.end('Not found');Заголовки
Заголовки описывают формат ответа, кэширование, авторизацию и другие параметры.
res.setHeader('Content-Type', 'application/json; charset=utf-8');
res.setHeader('Cache-Control', 'no-store');После отправки тела часть заголовков уже нельзя менять.
Тело ответа
const payload = {
ok: true,
data: [1, 2, 3],
};
res.setHeader('Content-Type', 'application/json; charset=utf-8');
res.end(JSON.stringify(payload));Для HTML:
res.setHeader('Content-Type', 'text/html; charset=utf-8');
res.end('<h1>Hello</h1>');Чтение JSON body
async function readJson(req) {
const chunks = [];
for await (const chunk of req) {
chunks.push(chunk);
}
return JSON.parse(Buffer.concat(chunks).toString('utf8'));
}В реальном сервере нужно ограничивать размер body, иначе клиент может отправить слишком большой запрос.
Что важно помнить
req— readable stream,res— writable stream.- Заголовки нельзя менять после начала отправки тела (
res.headersSent). req.urlне парсит query — используйтеnew URL(req.url, base).- Ограничивайте размер входящего body и обрабатывайте ошибки
JSON.parse.
Мини-шпаргалка
req- входящий запрос.res- исходящий ответ.req.urlне парсит query автоматически.reqможно читать как stream.- Ответ завершается через
res.end(). - Статус:
res.statusCode = 200. - Заголовок:
res.setHeader(name, value). - JSON-ответ:
Content-Type: application/json. - Тело ответа завершается через
res.end(body). - Размер входящего body нужно ограничивать.
Документация
Node.js: http.IncomingMessage, Node.js: http.ServerResponse.