re:re:actable
Урок 023 минуты чтения

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.methodHTTP-метод: 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.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам