HTMLImageElement: Image() constructor
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The Image()
constructor creates a new HTMLImageElement instance. It is functionally
equivalent to document.createElement('img').
Note:
This function should not be confused with the CSS image() function.
Syntax
new Image()
new Image(width)
new Image(width, height)
Parameters
widthOptional-
The width of the image (i.e., the value for the
widthattribute). heightOptional-
The height of the image (i.e., the value for the
heightattribute).
Usage note
The entire bitmap is loaded regardless of the sizes specified in the constructor. The
size specified in the constructor is reflected through the properties
HTMLImageElement.width and HTMLImageElement.height of the
resulting instance. The intrinsic width and height of the image in CSS pixels are
reflected through the properties HTMLImageElement.naturalWidth and
HTMLImageElement.naturalHeight. If no size is specified in the
constructor both pairs of properties have the same values.
Examples
const myImage = new Image(100, 200);
myImage.src = "picture.jpg";
document.body.appendChild(myImage);
This would be the equivalent of defining the following HTML tag inside the
<body>:
<img width="100" height="200" src="picture.jpg" />
Specifications
| Specification |
|---|
| HTML # dom-image-dev |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Image() constructor
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support