VideoPlaybackQuality: corruptedVideoFrames property

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

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

BCD tables only load in the browser

See also