Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Události `load` a `error` u obrázku

Zpracuj úspěch i selhání načítání přímo na prvku obrázku. Obě obslužné funkce zaregistruj před nastavením `src` a nepovažuj `complete` za potvrzení úspěchu.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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() vytvoří HTMLImageElement, tedy prvek <img>, který může načítat obrázek i bez vložení do dokumentu. Jde o API prohlížeče, nikoli o součást ECMAScript 2024. Prohlížeč na prvku vyvolá load, pokud se zdroj úspěšně načte, a error, pokud ho nelze načíst nebo použít, například kvůli nedostupné adrese URL nebo neplatným datům obrázku. Událost error u obrázku není vyvolaná výjimka JavaScriptu ani odpověď se stavovým kódem HTTP.

Poslouchej přímo na prvku obrázku: žádná z těchto událostí nebublá a žádnou nelze zrušit. Obě obslužné funkce zaregistruj pomocí addEventListener() ještě před přiřazením do src. Místo toho můžeš nastavit onload a onerror; nové přiřazení nahradí funkci v dané vlastnosti. Čtením src získáš adresu URL, ne výsledek načítání ani Promise.

Pokud již existující obrázek událost vyvolal, nový posluchač ji zpětně nedostane. Samotné complete úspěch nedokazuje: může být true i u nefunkčního obrázku nebo bez nastaveného zdroje. U očekávaného obrázku s kladnou přirozenou šířkou lze pomocí image.complete && image.naturalWidth > 0 ověřit, zda je už dostupný.

load neznamená, že už byl obrázek vykreslen. Pokud chceš před vložením do dokumentu počkat na dekódování, použij await image.decode() a ošetři zamítnutí příslibu. Úspěšné načtení obrázku z jiného původu samo o sobě neopravňuje ke čtení jeho pixelů z canvas; omezení CORS platí dál.

Příklady

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

Výsledek

load
error

Ulož příklad jako soubor `.html`, otevři ho v prohlížeči, který na této stránce povoluje obrázky z adres `data:`, a zkontroluj konzoli prohlížeče. Kód bez kontaktování externího serveru nejdříve vyzkouší platné SVG a potom neplatná obrazová data. Pro každý pokus použije vlastní obrázek a po získání výsledku odebere oba posluchače. Očekávané zprávy jsou `load` a poté `error`.

Související lekce

  • JavaScript · Lekce 33 · Pokročilá · Verze: 4

Zdroje