HTTP-запросы: структура, методы и отправка через XMLHttpRequest и Fetch API

Бесплатная консультация юриста

+7 (800) 302-87-29

Реклама jurik.ru

Взаимодействие браузера с сервером строится на протоколе HTTP (HyperText Transfer Protocol). Каждый раз, когда вы вводите адрес в строке браузера, нажимаете кнопку «Поиск» или отправляете форму обратной связи, происходит отправка HTTP-запроса. В этой статье мы подробно разберем, из чего состоит запрос, какие методы существуют и как отправлять запросы программно с помощью современных и классических инструментов.

Анатомия HTTP-запроса

Прежде чем отправлять запрос, важно понимать его структуру. Любой HTTP-запрос состоит из трех основных частей:

  1. Стартовая строка (Request Line): содержит метод (GET, POST и др.), URL ресурса и версию протокола (например, HTTP/1.1).
  2. Заголовки (Headers): метаданные в формате «Ключ: Значение». Примеры: Content-Type (тип данных), User-Agent (информация о клиенте), Authorization (токены доступа), Cookie.
  3. Тело запроса (Body): полезная нагрузка (payload). Обязательно для методов POST, PUT, PATCH. При GET-запросах тело обычно отсутствует, а параметры передаются в URL (query string).

Основные HTTP-методы

Метод определяет действие, которое клиент хочет выполнить над ресурсом:

  • GET, запрос данных с сервера (чтение). Параметры передаются в URL. Идемпотентен.
  • POST — отправка данных на сервер для создания нового ресурса (например, регистрация пользователя, отправка формы). Данные находятся в теле запроса.
  • PUT — полное обновление существующего ресурса.
  • PATCH — частичное обновление ресурса.
  • DELETE — удаление ресурса.
  • HEAD — аналогичен GET, но без тела ответа (только заголовки).
  • OPTIONS — запрос допустимых методов для ресурса (часто используется для CORS preflight).

Отправка запросов из браузера: Классический подход (XMLHttpRequest)

XMLHttpRequest (XHR) — это старый, но все еще рабочий API для асинхронного обмена данными. Он используется в легаси-коде и для специфических задач (например, отслеживание прогресса загрузки).

Пример GET-запроса:

const xhr = new XMLHttpRequest;
xhr.open('GET', 'https://api.example.com/data', true);

xhr.onload = function {
 if (xhr.status >= 200 && xhr.status < 300) {
 console.log('Успех:', JSON.parse(xhr.responseText));
 } else {
 console.error('Ошибка сервера:', xhr.status);
 }
};
xhr.onerror = function {
 console.error('Сетевая ошибка');
};

xhr.send;

Пример POST-запроса с JSON:

const xhr = new XMLHttpRequest;
xhr.open('POST', 'https://api.example.com/users', true);
xhr.setRequestHeader('Content-Type', 'application/json;charset=UTF-8');

const data = JSON.stringify({ name: 'Иван', email: 'ivan@example.com' });

xhr.onload = function {
 if (xhr.status === 201) {
 console.log('Пользователь создан:', xhr.responseText);

 }
};

xhr.send(data);

Современный стандарт: Fetch API

Fetch API — это современная замена XHR, основанная на Promise. Она чище, мощнее и является стандартом де-факто для современной веб-разработки.

Базовый GET-запрос:

fetch('https://api.example.com/data')
 .then(response => {
 if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
 return response.json;
 })
 .then(data => console.log('Данные получены:', data))
 .catch(error => console.error('Ошибка fetch:', error));

POST-запрос с async/await (рекомендуемый стиль):

async function createUser(userData) {
 try {
 const response = await fetch('https://api.example.com/users', {
 method: 'POST',
 headers: {
 'Content-Type': 'application/json',
 // 'Authorization': 'Bearer YOUR_TOKEN' // если нужна авторизация
 },
 body: JSON.stringify(userData)
 });

 if (!response.ok) {
 const errorData = await response.json;
 throw new Error(`Ошибка ${response.status}: ${errorData.message}`);
 }

 const result = await response.json;
 console.log('Успешный ответ:', result);
 return result;
 } catch (error) {
 console.error('Ошибка при отправке:', error);
 }
}
createUser({ name: 'Мария', role: 'admin' });

Работа с формами (FormData)

const form = document.getElementById('myForm');
form.addEventListener('submit', async (event) => {
 event.preventDefault; // Отменяем стандартную перезагрузку

 const formData = new FormData(form); // Автоматически собирает все input/select/textarea
  // Можно добавить дополнительные поля
 formData.append('timestamp', Date.now);

 try {
 const response = await fetch('/submit-form', {
 method: 'POST',
 body: formData // Заголовок Content-Type: multipart/form-data установится автоматически
 });
 
 const result = await response.json;
 alert('Форма отправлена: ' + result.message);
 } catch (e) {
 alert('Ошибка отправки');
 }
});

Отправка запросов в Node.js (Backend)

На сервере (Node.js) для обращения к внешним API используются встроенный модуль fetch (начиная с Node 18) или популярные библиотеки: axios, got, node-fetch (для старых версий).

Пример с нативным fetch (Node 18+):

async function getExternalData {
 const res = await fetch('https://jsonplaceholder.typicode.com/posts/1');
 const data = await res.json;
 console.log(data);
}
getExternalData;

Пример с Axios (популярен за удобство и интерцепторы):

const axios = require('axios');

axios.post('https://api.example.com/login', {
 username: 'user',
 password: 'pass'
 })
 .then(response => {
 console.log('Токен:', response.data.token);
 })
 .catch(error => {
 if (error.response) {
 console.error('Ошибка валидации:', error.response.data);
 } else {
 console.error('Сетевая ошибка:', error.message);
 }
 });

Инструменты для отладки и тестирования запросов

Разработка API немыслима без инструментов для ручной отправки и анализа запросов. Вот 5 мощных решений:

  1. DevTools браузера (Network tab) — встроенный инструмент. Позволяет видеть все запросы страницы, заголовки, тело, время ответа, коды состояния. Фильтрация по XHR/Fetch.
  2. Postman — стандарт индустрии для тестирования API. Поддерживает коллекции, переменные окружения, автотесты, генерацию кода.
  3. Insomnia — легковесная альтернатива Postman с чистым интерфейсом и поддержкой GraphQL/REST.
  4. cURL (консоль) — утилита командной строки. Идеальна для быстрых проверок, автоматизации в скриптах и копирования запросов из DevTools (Copy as cURL).
  5. HTTPie / Hoppscotch — удобные CLI и веб-альтернативы с подсветкой синтаксиса.

Типичные проблемы и решения

CORS (Cross-Origin Resource Sharing)

Браузер блокирует запросы к другому домену, если сервер не вернул заголовок Access-Control-Allow-Origin.

  • Решение: Настроить бэкенд на выдачу корректных CORS-заголовков; На фронтенде это обойти нельзя (кроме проксирования через свой бэкенд).

Коды состояния (Status Codes)

  • 2xx — успех (200 OK, 201 Created, 204 No Content).
  • 3xx — редирект (301, 302, 304 Not Modified).
  • 4xx, ошибка клиента (400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 422 Unprocessable Entity).
  • 5xx — ошибка сервера (500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable).

Безопасность: HTTPS и ключи API

Всегда используйте HTTPS. Никогда не храните секретные ключи (API Keys, JWT токены) в публичном фронтенд-коде (JavaScript, доступном в браузере). Используйте Backend-for-Frontend (BFF) паттерн: фронтенд обращается к вашему бэкенду, а тот уже с секретами ходит во внешние API.

Чек-лист перед отправкой запроса в продакшн

  • [ ] Используется HTTPS?
  • [ ] Установлен корректный Content-Type (application/json, multipart/form-data и т.д.)?
  • [ ] Обработаны ошибки сети (try/catch, .catch)?
  • [ ] Проверен response.ok / статус код перед парсингом тела?
  • [ ] Реализованы таймауты (AbortController для fetch) для предотвращения зависаний?
  • [ ] Добавлены заголовки кэширования (Cache-Control, ETag) при необходимости?
  • [ ] Логирование ошибок настроено на бэкенде и фронтенде?

Отправка HTTP-запроса, базовая навык веб-разработчика. От простой загрузки страницы (GET) до сложных цепочек микросервисов (POST/PUT/DELETE с авторизацией), принципы остаются одними: правильный URL, метод, заголовки и тело. Современный стандарт — Fetch API с async/await на фронтенде и Axios/native fetch на бэкенде. Для отладки незаменимы DevTools и Postman/Insomnia. Понимание структуры запроса и кодов ответа сэкономит часы отладки.