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