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

CKTIS / JavaScript

Image — създаване на елемент за изображение

Image създава HTMLImageElement извън дървото на документа. Незадължителните аргументи задават размерите, но не зареждат изображение и не променят размера на файла му.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

new Image(); new Image(width); new Image(width, height)

new Image() създава елемент img от тип HTMLImageElement, подобно на document.createElement("img"). Не го добавя в документа. Image е HTML API, достъпен в средата Window, а не част от ECMAScript; наличието на Node 24 в хранилище не доказва, че този API е достъпен. Съвременните браузърни енджини поддържат този конструктор.

Незадължителните аргументи width и height задават съответните атрибути за размери. Те не променят данните на изображението; CSS може да повлияе на крайния размер при показване. naturalWidth и naturalHeight описват естествените размери, коригирани спрямо плътността, в CSS пиксели; преди изображението да е достъпно, стойностите им са 0.

Задаването на src започва асинхронна обработка на ресурса, дори извън дървото на документа. Преди да покажете изображението, обработете събитията load и error или изпълнението и отхвърлянето на обещанието decode(). Само complete === true не доказва успех: стойността е приложима и когато липсва източник или е възникнала грешка. При показване на изображението задайте подходящ alt.

Примери

const image = new Image(32, 16);
console.log(image instanceof HTMLImageElement);
console.log(image.width, image.height);
console.log(image.isConnected);
console.log(image.naturalWidth, image.naturalHeight);

Резултат

true
32 16
false
0 0

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници