The VideoConfiguration dictionary of the Media Capabilities API is used to define the video file being tested when calling MediaCapabilities.encodingInfo() and MediaCapabilities.encodingInfo() to query whether a specific video configuration is supported, smooth, and/or power efficient.


The VideoConfiguration dictionary is made up of five video properties, including:

  • contentType: A valid video MIME type. For examples, see the list of Media formats for HTML video.
  • width: The width of the video.
  • height: The height of the video.
  • bitrate: The number of bits used to encode one second of the video file.
  • framerate: The number of frames making up one second of video playback.


//Create media configuration to be tested
const mediaConfig = {
    type : 'file',  // see MediaDecodingConfiguration and MediaEncodingConfiguration
    video : {
        contentType : "video/webm;codecs=vp8", // valid content type
        width : 800,     // width of the video
        height : 600,    // height of the video
        bitrate : 10000, // number of bits used to encode 1s of video
        framerate : 30   // number of frames making up that 1s.


Specification Status Comment
Media Capabilities
The definition of 'VideoConfiguration' in that specification.
Draft Initial definition

Browser compatibility

No compatibility data found. Please contribute data for "api.VideoConfiguration" (depth: 1) to the MDN compatibility data repository.

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.