CKTIS / JavaScript
Eventi `load` ed `error` di un’immagine
Gestisci il successo e il fallimento del caricamento sull’elemento immagine. Registra entrambi i gestori prima di impostare `src` e non usare `complete` come prova di successo.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
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() crea un HTMLImageElement, cioè un elemento <img> che può caricare un’immagine senza essere inserito nel documento. È un’API del browser, non parte di ECMAScript 2024. Il browser genera load sull’elemento se la risorsa viene caricata correttamente ed error se non può caricarla o usarla, per esempio se l’URL è irraggiungibile o i dati non sono validi. L’evento error dell’immagine non è né un’eccezione JavaScript né una risposta con un codice di stato HTTP.
Ascolta gli eventi sull’immagine stessa: non risalgono il DOM per bubbling e non sono annullabili. Registra entrambi i gestori con addEventListener() prima di assegnare src. In alternativa, imposta onload e onerror; una nuova assegnazione sostituisce il gestore della relativa proprietà. Leggere src restituisce un URL, non l’esito del caricamento né una Promise.
Se un’immagine esistente ha già generato un evento, un nuovo listener non lo riceverà retroattivamente. complete da solo non dimostra il successo: può valere true anche se l’immagine è inutilizzabile o non è stata impostata alcuna sorgente. Per un’immagine che ti aspetti abbia larghezza intrinseca positiva, image.complete && image.naturalWidth > 0 permette di verificare che sia già disponibile.
load non significa che l’immagine sia già stata disegnata sullo schermo. Per attendere la decodifica prima di inserirla nel documento, usa await image.decode() e gestisci il rifiuto della promessa. Caricare correttamente un’immagine di un’altra origine non basta a consentire la lettura dei suoi pixel da un canvas: restano valide le restrizioni CORS.
Esempi
<!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>Risultato
load error
Salva l’esempio come file `.html`, aprilo in un browser che consente le immagini `data:` su quella pagina e controlla la console del browser. Senza contattare un server esterno, il codice verifica prima un SVG valido e poi dati immagine non validi. Usa un’immagine distinta per ogni tentativo e rimuove entrambi i listener quando arriva l’esito. I messaggi attesi sono `load` e poi `error`.
Lezioni correlate
- JavaScript · Lezione 33 · Avanzato · Versione: 4