HTMLVideoElement: poster property

The poster property of the HTMLVideoElement interface is a string that reflects the URL for an image to be shown while no video data is available. If the property does not represent a valid URL, no poster frame will be shown.

It reflects the poster attribute of the <video> element.

Value

A string.

Examples

html
<video
  id="media"
  src="https://example.com/video.mp4"
  poster="https://example.com/poster.jpg"></video>
js
const el = document.getElementById("media");
console.log(el.poster); // Output: "https://example.com/poster.jpg"

Specifications

Specification
HTML Standard
# dom-video-poster

Browser compatibility

BCD tables only load in the browser