Краткий справочник

Шпаргалка по Fetch API в JavaScript

Краткое руководство по нативному методу fetch(): запросы GET/POST, полезная нагрузка JSON, заголовки, FormData и отмена запросов через AbortController.

· Опубликовано

Нативный JavaScript API fetch() предоставляет асинхронный интерфейс для выполнения сетевых HTTP-запросов в современных браузерах и Node.js.

Базовые запросы

GET-запрос (получение JSON)

async function loadUserData() {
  const response = await fetch('https://api.example.com/user/1');
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }
  const data = await response.json();
  return data;
}

POST-запрос (отправка JSON)

async function createUser(payload) {
  const response = await fetch('https://api.example.com/users', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json'
    },
    body: JSON.stringify(payload)
  });
  return await response.json();
}

Отправка данных формы (multipart/form-data)

const formData = new FormData();
formData.append('username', 'alice');
formData.append('avatar', fileInput.files[0]);

// Не указывайте Content-Type вручную, чтобы браузер сам выставил boundary
await fetch('/upload', {
  method: 'POST',
  body: formData
});

Отмена запросов и таймауты (AbortController)

const controller = new AbortController();
const signal = controller.signal;

// Автоматическая отмена запроса через 5 секунд
const timeoutId = setTimeout(() => controller.abort(), 5000);

try {
  const res = await fetch('https://api.example.com/data', { signal });
  const data = await res.json();
  clearTimeout(timeoutId);
  return data;
} catch (err) {
  if (err.name === 'AbortError') {
    console.warn('Запрос был отменен по таймауту');
  } else {
    console.error('Fetch error:', err);
  }
}

HTTP-заголовки, авторизация и учетные данные

const headers = new Headers();
headers.set('Authorization', 'Bearer token_xyz123'); // Заголовок авторизации с токеном Bearer
headers.set('X-Custom-Header', 'custom-value');

const response = await fetch('/api/secure', {
  headers,
  credentials: 'include' // Передача куки в cross-origin запросах
});

Ссылки и материалы

Связанные темы