CKTIS / JavaScript
Zdarzenia `load` i `error` obrazu
Obsługuj powodzenie i niepowodzenie ładowania bezpośrednio na elemencie obrazu. Zarejestruj obie funkcje obsługi przed ustawieniem `src` i nie traktuj `complete` jako potwierdzenia sukcesu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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() tworzy HTMLImageElement, czyli element <img>, który może ładować obraz bez wstawiania go do dokumentu. To API przeglądarki, nie część ECMAScript 2024. Przeglądarka wywołuje load na elemencie po pomyślnym załadowaniu zasobu, a error, gdy nie może go pobrać lub użyć, na przykład z powodu niedostępnego URL albo nieprawidłowych danych. Zdarzenie error obrazu nie jest wyjątkiem JavaScript ani odpowiedzią zawierającą kod stanu HTTP.
Nasłuchuj bezpośrednio na obrazie: żadne z tych zdarzeń nie przechodzi fazy bąbelkowania i żadnego nie można anulować. Zarejestruj obie funkcje za pomocą addEventListener() przed przypisaniem src. Alternatywnie ustaw onload i onerror; ponowne przypisanie do właściwości zastępuje poprzednią funkcję w tej właściwości. Odczyt src zwraca URL, nie wynik ładowania ani Promise.
Jeśli istniejący obraz zdążył wysłać zdarzenie, nowy nasłuch go nie odtworzy. Samo complete nie dowodzi powodzenia: może mieć wartość true także dla uszkodzonego obrazu lub przy braku źródła. Dla oczekiwanego obrazu o dodatniej szerokości wewnętrznej image.complete && image.naturalWidth > 0 pozwala sprawdzić, czy obraz jest już dostępny.
load nie oznacza, że obraz został już wyświetlony. Jeśli chcesz poczekać na dekodowanie przed wstawieniem go do dokumentu, użyj await image.decode() i obsłuż odrzucenie obietnicy. Pomyślne załadowanie obrazu z innego pochodzenia nie daje samo w sobie prawa do odczytu jego pikseli z płótna canvas; ograniczenia CORS nadal obowiązują.
Przykłady
<!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>Wynik
load error
Zapisz przykład jako plik `.html` i otwórz go w przeglądarce, która dopuszcza na tej stronie obrazy z adresów `data:`. Sprawdź komunikaty w konsoli przeglądarki. Bez żądań do zewnętrznego serwera kod sprawdza najpierw poprawny SVG, a potem nieprawidłowe dane. Używa osobnego obrazu dla każdej próby i usuwa oba nasłuchy po otrzymaniu wyniku. Oczekiwane komunikaty to kolejno `load` i `error`.
Powiązane lekcje
- JavaScript · Lekcja 33 · Zaawansowany · Wersja: 4