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