Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Image — crear un elemento de imagen

Image crea un HTMLImageElement fuera del árbol del documento. Los argumentos opcionales establecen sus dimensiones, pero no cargan una imagen ni cambian el tamaño del archivo.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

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

new Image() crea un elemento img de tipo HTMLImageElement, igual que document.createElement("img"). No lo inserta en el documento. Image es una API de HTML disponible en el entorno Window, no forma parte de ECMAScript; que Node 24 esté en un repositorio no demuestra que esta API esté disponible. Los motores de navegador actuales admiten este constructor.

Los argumentos opcionales width y height establecen los atributos de dimensión correspondientes. No cambian los datos de la imagen; CSS puede influir en el tamaño final mostrado. naturalWidth y naturalHeight describen las dimensiones naturales corregidas por densidad, en píxeles CSS; valen 0 antes de que la imagen esté disponible.

Al establecer src comienza el procesamiento asíncrono del recurso, incluso fuera del árbol del documento. Antes de mostrar la imagen, gestiona los eventos load y error, o la resolución y el rechazo de la promesa decode(). complete === true por sí solo no demuestra que haya habido éxito: también se aplica si falta la fuente o se produce un error. Al mostrar la imagen, establece un alt adecuado.

Ejemplos

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);

Resultado

true
32 16
false
0 0

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes