HTML Audio/Video DOM played Property

❮ HTML Audio/Video DOM Reference

Example

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

let 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.

Property
played Yes 9.0 15.0 Yes Yes

Syntax

audio|video.played

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
Copyright 1999-2023 by Refsnes Data. All Rights Reserved.