CKTIS / JavaScript
Događaji `load` i `error` pri učitavanju slike
Obradi uspjeh i neuspjeh učitavanja na samom elementu slike. Registriraj obje funkcije prije postavljanja `src` i ne uzimaj `complete` kao dokaz uspješnog učitavanja.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const image = new Image();
image.addEventListener("load", onLoad);
image.addEventListener("error", onError);
image.src = url;
// Alternative to addEventListener():
// image.onload = onLoad;
// image.onerror = onError;new Image() stvara HTMLImageElement, odnosno element <img> koji može učitati sliku bez umetanja u dokument. To je API preglednika, a ne dio standarda ECMAScript 2024. Preglednik na elementu pokreće load kada se resurs uspješno učita, a error kada ga ne može učitati ili upotrijebiti, primjerice zbog nedostupnog URL-a ili nevaljanih slikovnih podataka. Događaj error na slici nije bačena JavaScript iznimka ni odgovor s HTTP statusnim kodom.
Slušaj događaje na samoj slici: nijedan se ne širi prema precima u fazi bubblinga i nijedan se ne može otkazati. Registriraj obje funkcije pomoću addEventListener() prije dodjele vrijednosti u src. Umjesto toga možeš postaviti onload i onerror; nova dodjela zamjenjuje funkciju u tom svojstvu. Čitanjem src dobivaš URL, a ne ishod učitavanja ni Promise.
Ako je postojeća slika već pokrenula događaj, novi ga slušatelj neće primiti naknadno. Sam complete nije dokaz uspjeha: može biti true i ako je slika neispravna ili nije postavljen izvor. Ako očekuješ sliku pozitivne intrinzične širine, izraz image.complete && image.naturalWidth > 0 pomaže provjeriti je li već dostupna.
load ne znači da je slika već iscrtana. Ako želiš pričekati dekodiranje prije umetanja slike u dokument, upotrijebi await image.decode() i obradi odbijanje obećanja. Uspješno učitavanje slike s drugog izvora samo po sebi ne dopušta čitanje njezinih piksela iz elementa canvas; ograničenja CORS-a i dalje vrijede.
Primjeri
<!doctype html>
<meta charset="utf-8">
<title>Image load and error events</title>
<script>
(async () => {
function imageOutcome(url) {
return new Promise((resolve) => {
const image = new Image();
function finish(event) {
image.removeEventListener("load", finish);
image.removeEventListener("error", finish);
resolve(event.type);
}
image.addEventListener("load", finish);
image.addEventListener("error", finish);
image.src = url;
});
}
const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"><rect width="1" height="1"/></svg>';
const dataURL = (text) => `data:image/svg+xml,${encodeURIComponent(text)}`;
console.log(await imageOutcome(dataURL(svg)));
console.log(await imageOutcome(dataURL("not an SVG")));
})();
</script>Rezultat
load error
Spremi primjer kao datoteku `.html`, otvori je u pregledniku koji na toj stranici dopušta slike s URL-ovima `data:` i provjeri konzolu preglednika. Bez kontaktiranja vanjskog poslužitelja kôd prvo ispituje valjani SVG, a zatim nevaljane slikovne podatke. Za svaki pokušaj upotrebljava zasebnu sliku i uklanja oba slušatelja nakon primitka ishoda. Očekivane su poruke `load`, pa `error`.
Povezane lekcije
- JavaScript · Lekcija 33 · Napredno · Verzija: 4