Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

fetch — asynchronní načítání zdrojů

fetch() načte zdroj a vrátí Promise<Response>. Chybový stav HTTP příslib automaticky nezamítne; zkontrolujte response.ok.

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

Syntaxe

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

fetch(input, init?) je webové API, nikoli součást ECMAScriptu. Přijímá URL nebo objekt Request; volitelný parametr init nastavuje požadavek. Pokud není zadáno init.method, pro URL se použije výchozí metoda GET, zatímco existující objekt Request si ponechá svou metodu (například požadavek POST zůstane požadavkem POST).

await fetch(...) poskytne objekt Response, nikoli jeho již přečtený obsah. await response.json() přečte a zpracuje JSON; může příslib zamítnout. Obsah lze obvykle přečíst pouze jednou.

response.ok znamená, že stav je v rozmezí 200 až 299. Samotné HTTP stavy 404 a 500 příslib nezamítnou; síťové chyby ano. V prohlížečích platí CORS: mode: 'no-cors' neumožňuje číst odpověď z jiného původu.

Příklady

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

Výsledek

42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje