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

Как работает fetch и lifecycle запроса?

На этой странице
Кратко

fetch запускает HTTP request из JavaScript. Нужно понимать настройки method, headers, body, credentials, обработку status codes, JSON parsing, abort и отличие HTTP-ошибок от network errors.

Вопрос

Как работает fetch? Как обрабатывать HTTP-ошибки, сетевые ошибки и отмену запроса?

Базовый GET

const response = await fetch('/api/users');
const users = await response.json();

На 404 или 500 fetch не бросит exception. Поэтому нужно проверять:

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

POST с JSON

const response = await fetch('/api/users', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: JSON.stringify({
    email: 'anna@example.com',
  }),
});

Content-Type описывает request body. Accept описывает желаемый response.

Credentials

Для cookie auth на cross-origin:

fetch('https://api.example.com/me', {
  credentials: 'include',
});

Без credentials: 'include' cookies могут не отправиться.

AbortController

const controller = new AbortController();
 
const promise = fetch('/api/search?q=vue', {
  signal: controller.signal,
});
 
controller.abort();

Abort полезен для search, route changes, component unmount.

Network error vs HTTP error

HTTP error:

Response пришел: 404, 500, 422

Network-level error:

DNS failed, connection refused, CORS blocked, request aborted

catch обычно ловит именно network-level errors и aborts, а не 404.

Что важно помнить

  • Тело ответа можно прочитать только один раз; для повторного чтения используйте response.clone().
  • У fetch нет встроенного таймаута: используйте AbortSignal.timeout(5000) или AbortController.
  • Отмена запроса через abort() отклоняет промис с DOMException с именем AbortError — его обычно не показывают пользователю.
  • Для отслеживания прогресса загрузки файла fetch пока неудобен, поэтому для upload progress часто используют XHR.

Мини-шпаргалка

  • fetch возвращает Response.
  • Проверяй response.ok.
  • Content-Type - что отправляем.
  • Accept - что хотим получить.
  • Cookies cross-origin требуют credentials: 'include'.
  • AbortController отменяет request.

Документация

MDN: Fetch API, MDN: AbortSignal.timeout.

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

Поиск

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