Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

fetch — asynchroniczne pobieranie zasobów

fetch() pobiera zasób i zwraca Promise<Response>. Status HTTP błędu nie odrzuca automatycznie obietnicy; sprawdź response.ok.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

fetch(input, init?) → Promise<Response>

fetch(input, init?) to Web API, nie element ECMAScript. Przyjmuje URL lub Request; opcjonalne init konfiguruje żądanie. Jeśli init.method nie jest podane, dla URL używana jest metoda GET, a dla istniejącego obiektu Request zachowywana jest jego metoda (np. POST pozostaje POST).

await fetch(...) udostępnia Response, nie odczytaną treść. await response.json() odczytuje i parsuje JSON; może odrzucić obietnicę. Treść zwykle można odczytać tylko raz.

response.ok oznacza status 200–299. HTTP 404 i 500 same nie odrzucają obietnicy; błędy sieciowe tak. W przeglądarce obowiązuje CORS: mode: 'no-cors' nie odblokowuje odczytu odpowiedzi między źródłami.

Przykłady

async function main() {
  const response = await fetch('data:application/json,%7B%22value%22%3A42%7D');
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`);
  }
  const data = await response.json();
  console.log(data.value);
}

main().catch(console.error);

Wynik

42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła