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
fetchvždy skontrolujteodpoved.ok– stav 404 či 500 výnimku nevyvolá. - Pri POST posielajte
JSON.stringify(…)a hlavičkuContent-Type: application/json. - Nastavte časový limit cez
AbortSignal.timeout(). - Nezávislé požiadavky spúšťajte cez
Promise.allaleboPromise.allSettled.