Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła