MDN self-hosted library · e01.org

HTMLImageElement: src property

HTML DOM

Open notebook · 1 cells web-api-instance-property upstream source

HTML DOM

The src property of the HTMLImageElement interface specifies the image to display in the img element. It reflects the <img> element's src content attribute.

Setting src property triggers scheduling of a task to fetch the specified resource; the element does not need to be inserted into the active document first. Unless loading is set to lazy, the image will be fetched almost immediately (if lazy loading is specified the request is deferred until the element is near the viewport: which can't happen until the element is inserted).

Value

A string. For more information about the syntax of the src attribute, see the HTML <img> reference.

Examples

Setting the src attribute

const img = new Image();
img.src = "example.png";
img.alt = "An example picture";

Specifications

Browser compatibility

See also

  • HTMLImageElement.currentSrc
  • HTMLImageElement.srcset
  • HTMLImageElement.sizes