Tutorials References Exercises Sign Up Menu
Create Website Get Certified Pro

HTML Audio/Video DOM played Property

❮ HTML Audio/Video DOM Reference


Get the first played range (part) of the video in seconds:

var vid = document.getElementById("myVideo");
alert("Start: " + vid.played.start(0) + " End: " + vid.played.end(0));
Try it Yourself »

Definition and Usage

The played property returns a TimeRanges object.

The TimeRanges object represents ranges of the audio/video that has already been played (seen) by the user.

A played range is a time-range of played audio/video. The user gets several played ranges if he/she skips in the audio/video.

Note: This property is read-only.

Browser Support

The numbers in the table specify the first browser version that fully supports the property.

played Yes 9.0 15.0 Yes Yes



Return Value

Type Description
TimeRanges Object Represents the played parts of the audio/video.

TimeRanges Object Properties:

  • length - get the number of played ranges in the audio/video
  • start(index) - get the start position of a played range
  • end(index) - get the end position of a played range

Note: The first played range is index 0

❮ HTML Audio/Video DOM Reference