Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Dogodka `load` in `error` pri sliki

Uspeh in neuspeh nalaganja obravnavaj neposredno na slikovnem elementu. Obe funkciji registriraj, preden nastaviš `src`, in ne jemlji `complete` kot dokaz uspešnega nalaganja.

Različica: 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() ustvari HTMLImageElement, torej element <img>, ki lahko naloži sliko, ne da bi ga vstavil v dokument. To je API brskalnika, ne del ECMAScript 2024. Brskalnik na elementu sproži load, če se vir uspešno naloži, in error, če ga ne more naložiti ali uporabiti, na primer zaradi nedosegljivega URL-ja ali neveljavnih slikovnih podatkov. Dogodek error pri sliki ni sprožena izjema JavaScript niti odgovor s statusno kodo HTTP.

Dogodka poslušaj neposredno na sliki: nobeden ne potuje navzgor po drevesu DOM v fazi mehurjenja in nobenega ni mogoče preklicati. Obe funkciji registriraj z addEventListener(), preden nastaviš src. Lahko pa nastaviš onload in onerror; ponovna prireditev zamenja funkcijo v tej lastnosti. Z branjem src dobiš URL, ne rezultata nalaganja ali objekta Promise.

Če je obstoječa slika dogodek že sprožila, ga novi poslušalec ne bo prejel za nazaj. Sam complete ne dokazuje uspeha: vrednost je lahko true tudi pri pokvarjeni sliki ali kadar vir ni nastavljen. Če pričakuješ sliko s pozitivno naravno širino, lahko z image.complete && image.naturalWidth > 0 preveriš, ali je že na voljo.

load ne pomeni, da je bila slika že izrisana. Če želiš pred vstavljanjem v dokument počakati na dekodiranje, uporabi await image.decode() in obravnavaj zavrnitev obljube. Uspešno nalaganje slike z drugega izvora samo po sebi ne dovoli branja njenih slikovnih pik iz canvas; omejitve CORS še vedno veljajo.

Primeri

<!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

Shrani primer kot datoteko `.html`, odpri jo v brskalniku, ki na tej strani dovoljuje slike z URL-ji `data:`, in preveri konzolo brskalnika. Koda brez stika z zunanjim strežnikom najprej preizkusi veljaven SVG, nato neveljavne slikovne podatke. Za vsak poskus uporabi ločeno sliko in ob prejemu izida odstrani oba poslušalca. Pričakovani sporočili sta `load` in nato `error`.

Povezane lekcije

  • JavaScript · Lekcija 33 · Napredna · Različica: 4

Viri