Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Udalosti `load` a `error` pri obrázku

Spracuj úspech aj zlyhanie načítania priamo na prvku obrázka. Obe obslužné funkcie zaregistruj pred nastavením `src` a nepovažuj `complete` za dôkaz úspechu.

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

Syntax

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() vytvorí HTMLImageElement, teda prvok <img>, ktorý môže načítať obrázok aj bez vloženia do dokumentu. Je to API prehliadača, nie súčasť ECMAScript 2024. Prehliadač na prvku vyvolá load pri úspešnom načítaní zdroja a error, ak zdroj nemôže načítať alebo použiť, napríklad pre nedostupnú adresu URL alebo neplatné obrazové údaje. Udalosť error obrázka nie je vyvolaná výnimka JavaScriptu ani odpoveď so stavovým kódom HTTP.

Udalosti počúvaj priamo na prvku obrázka: ani jedna nebublá a ani jedna sa nedá zrušiť. Obe obslužné funkcie zaregistruj pomocou addEventListener() pred priradením hodnoty do src. Prípadne nastav onload a onerror; ďalšie priradenie nahradí funkciu v danej vlastnosti. Čítaním src získaš adresu URL, nie výsledok načítania ani Promise.

Ak už existujúci obrázok vyvolal udalosť, nový poslucháč ju spätne nedostane. Samotné complete nedokazuje úspech: môže byť true aj pri nefunkčnom obrázku alebo keď nie je nastavený žiadny zdroj. Pri očakávanom obrázku s kladnou prirodzenou šírkou môžeš pomocou image.complete && image.naturalWidth > 0 skontrolovať, či je už dostupný.

load neznamená, že obrázok už bol vykreslený. Ak chceš pred vložením do dokumentu počkať na dekódovanie, použi await image.decode() a ošetri zamietnutie prísľubu. Úspešné načítanie obrázka z iného pôvodu samo osebe neumožňuje čítať jeho pixely z canvas; obmedzenia CORS stále platia.

Prí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ýsledok

load
error

Ulož príklad ako súbor `.html`, otvor ho v prehliadači, ktorý na tejto stránke povoľuje obrázky z adries `data:`, a skontroluj konzolu prehliadača. Bez kontaktovania externého servera kód najprv vyskúša platné SVG a potom neplatné obrazové údaje. Pri každom pokuse použije samostatný obrázok a po získaní výsledku odstráni oba poslucháče. Očakávané správy sú `load` a potom `error`.

Súvisiace lekcie

  • JavaScript · Lekcia 33 · Pokročilá · Verzia: 4

Zdroje