HTMLImageElement: Image() constructor
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML DOM")}}
The **Image()** constructor creates a new {{DOMxRef("HTMLImageElement")}} instance. It is functionally equivalent to {{DOMxRef("Document.createElement()", "document.createElement('img')")}}.
توجه: This function should not be confused with the CSS [image()](/en-US/docs/Web/CSS/Reference/Values/image/image) function.
Syntax
new Image()
new Image(width)
new Image(width, height)Parameters
width{{optional_inline}}- : The width of the image (i.e., the value for the [
width](/en-US/docs/Web/HTML/Reference/Elements/img#width)
attribute).
height{{optional_inline}}- : The height of the image (i.e., the value for the [
height](/en-US/docs/Web/HTML/Reference/Elements/img#height)
attribute).
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 {{DOMxRef("HTMLImageElement.width")}} and {{DOMxRef("HTMLImageElement.height")}} of the resulting instance. The intrinsic width and height of the image in CSS pixels are reflected through the properties {{DOMxRef("HTMLImageElement.naturalWidth")}} and {{DOMxRef("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 {{HTMLElement("body")}}:
<img width="100" height="200" src="picture.jpg" />Specifications
{{Specifications}}
Browser compatibility
{{Compat}}