Snelle referentie

JavaScript Fetch-API Spiekbrief

Een snelle gids voor de native fetch() API: GET/POST-verzoeken, JSON-payloads, HTTP-headers, FormData en annulering via AbortController.

· Gepubliceerd

De native JavaScript fetch() API biedt een asynchrone interface voor het ophalen van netwerkbronnen in moderne browsers en Node.js.

Basisverzoeken

GET-verzoek (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-verzoek (JSON-payload)

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();
}

Formuliergegevens verzenden (multipart/form-data)

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

// Laat Content-Type weg zodat de browser automatisch de boundary instelt
await fetch('/upload', {
  method: 'POST',
  body: formData
});

Verzoeken Annuleren en Time-outs (AbortController)

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

// Annuleer verzoek automatisch na 5 seconden
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('Verzoek afgebroken wegens time-out');
  } else {
    console.error('Fetch error:', err);
  }
}

Headers, Authenticatie en Inloggegevens

const headers = new Headers();
headers.set('Authorization', 'Bearer token_xyz123'); // Bearer-token authenticatieheader
headers.set('X-Custom-Header', 'custom-value');

const response = await fetch('/api/secure', {
  headers,
  credentials: 'include' // Cookies meesturen bij cross-origin verzoeken
});

Referenties

Verwante onderwerpen