JavaScript - fetch a async/await: načítanie dát z API

Funkcia fetch je štandardný spôsob, ako z JavaScriptu poslať HTTP požiadavku – v prehliadači aj v Node.js (od verzie 18). V spojení s async/await je kód krátky a číta sa zhora nadol. Má však niekoľko vlastností, ktoré začiatočníkov prekvapia, hlavne to, že odpoveď 404 alebo 500 sa nepovažuje za chybu.

Základné načítanie JSON

async function nacitajPouzivatela(id) {
  const odpoved = await fetch(`https://api.example.com/users/${id}`);
  const pouzivatel = await odpoved.json();
  return pouzivatel;
}

const pouzivatel = await nacitajPouzivatela(1);
console.log(pouzivatel.name);

Čaká sa dvakrát: prvé await na hlavičky odpovede, druhé na stiahnutie a rozparsovanie tela.

fetch nehlási HTTP chyby

Promise z fetch sa zamietne iba pri chybe siete (server neexistuje, výpadok spojenia, zablokované CORS). Odpoveď so stavom 404 alebo 500 je z pohľadu fetch úspech – treba skontrolovať odpoved.ok.

async function nacitajJson(url, moznosti = {}) {
  const odpoved = await fetch(url, moznosti);

  if (!odpoved.ok) {
    throw new Error(`HTTP ${odpoved.status} ${odpoved.statusText} – ${url}`);
  }

  return odpoved.json();
}

try {
  const clanky = await nacitajJson('https://api.example.com/articles');
  console.log(`Načítaných článkov: ${clanky.length}`);
} catch (chyba) {
  console.error('Načítanie zlyhalo:', chyba.message);
}

Pomocnú funkciu nacitajJson používame aj v ďalších príkladoch.

Parametre v adrese

Parametre neskladajte ručne spájaním reťazcov. URLSearchParams sa postará o správne zakódovanie medzier a diakritiky.

const parametre = new URLSearchParams({ q: 'okenné funkcie', strana: 2 });
const vysledky = await nacitajJson(`https://api.example.com/search?${parametre}`);
// → https://api.example.com/search?q=okenn%C3%A9+funkcie&strana=2

Odoslanie dát metódou POST

const novy = await nacitajJson('https://api.example.com/articles', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ title: 'Nový článok', published: true })
});

console.log(`Vytvorený článok s ID ${novy.id}`);

Častá chyba je poslať objekt priamo v body – odošle sa text [object Object]. Telo musí byť reťazec, preto JSON.stringify, a server potrebuje hlavičku Content-Type.

Časový limit požiadavky

Samotný fetch časový limit nemá a na pomalý server čaká veľmi dlho. Limit sa nastaví signálom:

try {
  const data = await nacitajJson('https://api.example.com/report', {
    signal: AbortSignal.timeout(5000) // 5 sekúnd
  });
} catch (chyba) {
  if (chyba.name === 'TimeoutError') {
    console.error('Server neodpovedal do 5 sekúnd.');
  } else {
    throw chyba;
  }
}

Ak chcete požiadavku zrušiť sami (používateľ klikol na „Zrušiť“ alebo začal písať nový hľadaný výraz), použite AbortController:

let ovladac = null;

async function hladaj(vyraz) {
  ovladac?.abort();               // zruší predchádzajúce hľadanie
  ovladac = new AbortController();

  try {
    const parametre = new URLSearchParams({ q: vyraz });
    return await nacitajJson(`https://api.example.com/search?${parametre}`, {
      signal: ovladac.signal
    });
  } catch (chyba) {
    if (chyba.name === 'AbortError') {
      return null;                // zrušené zámerne, nie je to chyba
    }
    throw chyba;
  }
}

Viac požiadaviek naraz

Nezávislé požiadavky nečakajte po jednej. Promise.all ich spustí súčasne a počká na všetky:

// POMALÉ: druhá požiadavka začne až po skončení prvej
const pouzivatel = await nacitajJson('/api/user/1');
const objednavky = await nacitajJson('/api/user/1/orders');

// RÝCHLE: obe bežia súčasne
const [pouzivatel2, objednavky2] = await Promise.all([
  nacitajJson('/api/user/1'),
  nacitajJson('/api/user/1/orders')
]);

Promise.all zlyhá hneď, ako zlyhá ktorákoľvek požiadavka. Ak chcete výsledky aj pri čiastočnom neúspechu, použite Promise.allSettled:

const vysledky = await Promise.allSettled([
  nacitajJson('/api/pocasie'),
  nacitajJson('/api/kurzy'),
  nacitajJson('/api/spravy')
]);

for (const vysledok of vysledky) {
  if (vysledok.status === 'fulfilled') {
    console.log('OK:', vysledok.value);
  } else {
    console.warn('Zlyhalo:', vysledok.reason.message);
  }
}

Zhrnutie

  • Po fetch vždy skontrolujte odpoved.ok – stav 404 či 500 výnimku nevyvolá.
  • Pri POST posielajte JSON.stringify(…) a hlavičku Content-Type: application/json.
  • Nastavte časový limit cez AbortSignal.timeout().
  • Nezávislé požiadavky spúšťajte cez Promise.all alebo Promise.allSettled.
O autorovi

Ing.Jaroslav Vadel

Som zakladateľom www.projectik.eu. Hrám sa na programátora, ktorý ovláda: c#,cpp,java,unity3d,php,html,NI testand,NI Vision Builder,Cognex In-Sight,NI LabView "Naprogramovať program, ktorý funguje vie každy. Ale to, že program funguje ešte neznamena, že je napísany správne "

Súvisiace články