MediaSource: isTypeSupported() static method

The MediaSource.isTypeSupported() static method returns a boolean value which is true if the given MIME type and (optional) codec are likely to be supported by the current user agent.

That is, if it can successfully create SourceBuffer objects for that media type. If the returned value is false, then the user agent is certain that it cannot access media of the specified format.

Syntax

js
MediaSource.isTypeSupported(type)

Parameters

type

A string specifying the MIME type of the media and (optionally) a codecs parameter containing a comma-separated list of the supported codecs.

Return value

A value of false if the media of the given type will not play.

A value of true is returned if the browser can probably play media of the specified type. This is not a guarantee, and your code must be prepared for the possibility that the media will not play correctly if at all.

All web APIs that work with media files use a "no/maybe/probably" approach (or, in this case, "no or probably") when determining if a media type can be used. This is because media files are complex, intricate constructs with far too many subtle variations to be absolutely certain of anything until you actually use the contents of the media.

Examples

The following snippet is from an example written by Nick Desaulniers (view the full demo live, or download the source for further investigation). The function getMediaSource(), which is not defined here, returns a MediaSource.

js
const assetURL = "frag_bunny.mp4";
// Need to be specific for Blink regarding codecs
// ./mp4info frag_bunny.mp4 | grep Codec
const mimeCodec = 'video/mp4; codecs="avc1.42E01E, mp4a.40.2"';
let mediaSource;

if ("MediaSource" in window && MediaSource.isTypeSupported(mimeCodec)) {
  mediaSource = getMediaSource();
  console.log(mediaSource.readyState); // closed
  video.src = URL.createObjectURL(mediaSource);
  mediaSource.addEventListener("sourceopen", sourceOpen);
} else {
  console.error("Unsupported MIME type or codec: ", mimeCodec);
}

function sourceOpen() {
  console.log(this.readyState); // open
  const sourceBuffer = mediaSource.addSourceBuffer(mimeCodec);
  fetchAB(assetURL, (buf) => {
    sourceBuffer.addEventListener("updateend", () => {
      mediaSource.endOfStream();
      video.play();
      console.log(mediaSource.readyState); // ended
    });
    sourceBuffer.appendBuffer(buf);
  });
}

Specifications

Specification
Media Source Extensions™
# dom-mediasource-istypesupported

Browser compatibility

BCD tables only load in the browser

See also