CKTIS / JavaScript
fetch — asinhrono pridobivanje virov
fetch() pridobi vir in vrne Promise<Response>. Stanje HTTP z napako promise samodejno ne zavrne; preverite response.ok.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
fetch(input, init?) → Promise<Response>fetch(input, init?) je spletni API, ne del ECMAScripta. Sprejme URL ali objekt Request; neobvezni parameter init nastavi zahtevo. Če init.method ni podan, se pri URL-ju uporabi privzeta metoda GET, obstoječi objekt Request pa ohrani svojo metodo (zahteva POST na primer ostane zahteva POST).
await fetch(...) zagotovi objekt Response, ne pa že prebrane vsebine. await response.json() prebere in razčleni JSON; promise lahko zavrne. Vsebino je običajno mogoče prebrati samo enkrat.
response.ok pomeni, da je stanje med 200 in 299. HTTP-stanji 404 in 500 sami po sebi ne zavrneta promise; omrežne napake jo. V brskalnikih velja CORS: mode: 'no-cors' ne omogoča branja odgovora iz drugega izvora.
Primeri
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);Rezultat
42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.