Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori