База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Събития `load` и `error` при изображения

Обработвай успешното и неуспешното зареждане върху самия елемент на изображението. Регистрирай и двата обработчика преди задаването на `src` и не приемай `complete` като доказателство за успех.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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() създава HTMLImageElement, тоест елемент <img>, който може да зареди изображение, без да е вмъкнат в документа. Това е API на браузъра, а не част от ECMAScript 2024. Браузърът изпраща load към елемента при успешно зареждане на ресурса и error, ако не може да го зареди или използва, например при недостъпен URL или невалидни данни на изображението. Събитието error на изображението не е нито хвърлено JavaScript изключение, нито отговор с HTTP код за състояние.

Слушай за събитията върху самия елемент: нито едно не се разпространява нагоре във фазата на изплуване и нито едно не може да бъде отменено. Регистрирай двата обработчика с addEventListener(), преди да зададеш src. Можеш вместо това да зададеш onload и onerror; повторно присвояване заменя обработчика в съответното свойство. При прочитане на src получаваш URL, а не резултат от зареждането или Promise.

Ако съществуващо изображение вече е изпратило събитие, нов слушател няма да го получи със задна дата. Само по себе си complete не доказва успех: то може да е true и при неизползваемо изображение или без зададен източник. Ако очакваш изображение с положителна естествена ширина, image.complete && image.naturalWidth > 0 служи за проверка дали то вече е налично.

load не означава, че изображението вече е изчертано. Ако трябва да изчакаш декодирането преди вмъкване в документа, използвай await image.decode() и обработи отхвърлянето на обещанието. Успешното зареждане на изображение от друг произход само по себе си не позволява да прочетеш пикселите му от canvas; ограниченията на CORS продължават да важат.

Примери

<!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>

Резултат

load
error

Запази примера като файл с разширение `.html`, отвори го в браузър, който позволява изображения с URL адреси `data:` на тази страница, и провери конзолата на браузъра. Без връзка с външен сървър кодът проверява първо валиден SVG, а после невалидни данни за изображение. За всеки опит използва отделно изображение и премахва двата слушателя при получаване на резултата. Очакваните съобщения са `load`, последвано от `error`.

Свързани уроци

  • JavaScript · Урок 33 · Напреднало · Версия: 4

Източници