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