Skip to Content
Platform.Ontology

Media Capabilities

Which video and audio formats decode smoothly and power-efficiently on this device.

Gets silentlyDevice detailsMediaWeb browsersWhen the page loadsWhile you use it

In one line

Can ask how well your device plays each video and audio format

Which video and audio formats decode smoothly and power-efficiently on this device.

Reveals hardware decoder generation, HDR support and codecs (AV1, HEVC, VP9, Dolby) and so GPU and OS tier. Sites use it to pick streams; it also fingerprints the device.

What it can and can't do

What the user does: Nothing. It happens when a video page or player loads

It can

  • Check which formats play smoothly and save battery
  • Check for HDR and codec support such as AV1, HEVC, or Dolby
  • Pick the best stream for your screen
  • Guess your graphics tier from the answers

It cannot

  • See your videos or watch history
  • See your exact graphics card
  • Ask about formats the browser does not know
  • Change how your device plays video

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported662018-04-17None
EdgeSupported792020-01-15None
FirefoxSupported632018-10-23None
SafariSupported132019-09-19None
Safari on iPhoneSupported132019-09-19None
Chrome on AndroidSupported662018-04-17None
Samsung InternetSupported9.02018-09-15None

How a site asks for it

APInavigator.mediaCapabilities.decodingInfo(), encodingInfo()
Browser compat keysapi.MediaCapabilities.decodingInfo
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)No
Needs a user gestureNo
How long it lastsread fresh on every page load; nothing stored
How to take it backnone needed (no grant)
Inside an iframeReadable from cross-origin iframes too (same values)

Typical flow

  1. Page script reads the value
  2. No prompt is shown

Data you get

Shape: object
How often: static per session

FieldTypeUnitRangePrecision
supportedbooleanNonetrue or falseNot listed
smoothbooleanNonetrue or falseNot listed
powerEfficientbooleanNonetrue or falseNot listed

Technical limits

  • Answers per queried configuration; nothing listed upfront
  • Cannot enumerate all codecs at once

The story

What it is

Tells a page which video and sound formats play smoothly and use little battery on your device.

For you

You never see it. It helps your video start in the best quality your device can really play, without stutter or a hot laptop. The cost is that the answers also say a lot about your hardware.

For makers

Streaming sites use it to choose between formats like AV1, HEVC and VP9 and to avoid choppy video. It reveals decoder generation, HDR and GPU tier. That makes it useful to measure users and to fingerprint them.

Where you see it

TypeExampleApps
videoA streaming site picks 4K HDR for a TV-class display and 1080p for a basic laptop.Netflix, Disney+
videoA video site chooses AV1 only on devices with a hardware decoder, to save battery.YouTube
gamesA cloud gaming site picks the stream format that your device decodes smoothly for low delay.Xbox Cloud Gaming, GeForce NOW
liveA live sports stream drops to a simpler format on a phone that cannot decode the best one smoothly.None named
videoA video call app selects an encoder that will not overheat your device.Zoom
adsA video ad server picks a creative format your device decodes without lag.None named
securityA fingerprint vendor reads the decoder answers to tell GPU generations apart.None named

Risks

  • Shows hardware tier
  • Useful for fingerprinting

What the platform says

Good uses and abuse

Legitimate uses

  • Adaptive streaming
  • Pick HDR stream

Known abuse

  • Hardware generation inference

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits3Rough identifying entropy, when known

Sources

How well checked: Based on official documentation.

On this page