HTMLImageElement: src property
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 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
| Specification |
|---|
| HTML # dom-img-src |