HTTP Methods

Вивчимо GET, POST, PUT, PATCH, DELETE та інші HTTP-методи й визначимо їхнє призначення.

Що таке HTTP-метод

HTTP-метод визначає, яку дію клієнт хоче виконати над ресурсом на сервері.

Наприклад, ресурсом може бути користувач:

text

/users
/users/42

Клієнт надсилає HTTP-запит, у якому вказує:

метод;
URL;
заголовки;
за потреби — тіло запиту.

Приклад запиту:

http

GET /users/42 HTTP/1.1
Host: example.com

text

GET    /users       отримати всіх користувачів
GET    /users/42    отримати одного користувача
POST   /users       створити користувача
PUT    /users/42    повністю замінити користувача
PATCH  /users/42    частково змінити користувача
DELETE /users/42    видалити користувача

javascript

const http = require('node:http');

const users = [
  { id: 1, name: 'Олена' },
  { id: 2, name: 'Андрій' },
];

function sendJson(response, statusCode, data) {
  response.writeHead(statusCode, {
    'Content-Type': 'application/json; charset=utf-8',
  });

  response.end(JSON.stringify(data));
}

function readRequestBody(request) {
  return new Promise((resolve, reject) => {
    let body = '';

    request.on('data', (chunk) => {
      body += chunk;
    });

    request.on('end', () => {
      if (body === '') {
        resolve({});
        return;
      }

      try {
        resolve(JSON.parse(body));
      } catch {
        reject(new Error('Некоректний JSON'));
      }
    });

    request.on('error', reject);
  });
}

const server = http.createServer(async (request, response) => {
  const url = new URL(request.url, `http://${request.headers.host}`);
  const method = request.method;

  if (url.pathname === '/users' && method === 'GET') {
    sendJson(response, 200, users);
    return;
  }

  if (url.pathname === '/users' && method === 'POST') {
    try {
      const body = await readRequestBody(request);

      if (typeof body.name !== 'string' || body.name.trim() === '') {
        sendJson(response, 400, { error: 'Поле name є обов’язковим' });
        return;
      }

      const user = {
        id: users.length + 1,
        name: body.name,
      };

      users.push(user);
      sendJson(response, 201, user);
    } catch {
      sendJson(response, 400, { error: 'Некоректний JSON' });
    }

    return;
  }

  const userMatch = url.pathname.match(/^\/users\/(\d+)$/);

  if (userMatch) {
    const userId = Number(userMatch[1]);
    const userIndex = users.findIndex((user) => user.id === userId);

    if (userIndex === -1) {
      sendJson(response, 404, { error: 'Користувача не знайдено' });
      return;
    }

    if (method === 'GET') {
      sendJson(response, 200, users[userIndex]);
      return;
    }

    if (method === 'PATCH') {
      try {
        const body = await readRequestBody(request);

        if (typeof body.name === 'string' && body.name.trim() !== '') {
          users[userIndex].name = body.name;
        }

        sendJson(response, 200, users[userIndex]);
      } catch {
        sendJson(response, 400, { error: 'Некоректний JSON' });
      }

      return;
    }

    if (method === 'DELETE') {
      const deletedUser = users.splice(userIndex, 1)[0];
      sendJson(response, 200, deletedUser);
      return;
    }
  }

  sendJson(response, 404, { error: 'Маршрут не знайдено' });
});

server.listen(3000, () => {
  console.log('Сервер запущено на http://localhost:3000');
});

HTTP Methods

Що таке HTTP-метод

Основні HTTP-методи

GET

POST

PUT

PATCH

DELETE

Інші HTTP-методи

HEAD

OPTIONS

TRACE

CONNECT

Методи та CRUD

Приклад HTTP-сервера в Node.js

HTTP-метод і тіло запиту

Коди відповіді та методи

Безпечні та ідемпотентні методи

Типові помилки

Використання GET для зміни даних

Плутанина між PUT і PATCH

Відсутній Content-Type для JSON

Неправильний метод для маршруту

Ігнорування тіла запиту

Підсумок