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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.