VideoPlaybackQuality: corruptedVideoFrames property

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

The VideoPlaybackQuality interface's read-only corruptedVideoFrames property the number of corrupted video frames that have been received since the <video> element was last loaded or reloaded.

Value

The number of corrupted video frames that have been received since the <video> element was last loaded or reloaded.

It is up to the user agent to determine whether or not to display a corrupted video frame. If a corrupted frame is dropped, then both corruptedVideoFrames and droppedVideoFrames are incremented.

Examples

This example determines the percentage of frames which have been corrupted, and if the value is greater than 5%, calls a function called downgradeVideo() that would be implemented to switch to a different video that might tax the network less.

js
const videoElem = document.getElementById("my_vid");
const quality = videoElem.getVideoPlaybackQuality();

if (quality.corruptedVideoFrames / quality.totalVideoFrames > 0.05) {
  downgradeVideo(videoElem);
}

Specifications

Specification
Media Playback Quality
# dom-videoplaybackquality-corruptedvideoframes

Browser compatibility

See also