HTMLMediaElement.canPlayType()

HTMLMediaElement.canPlayType() メソッドは、指定されたメディアタイプを再生できるかどうかを決定します。

注: この機能は Web Workers では利用できません。

構文

str = audioOrVideo.canPlayType(mediaType);

パラメーター

mediaType
メディアの MIME タイプを含む DOMString。

戻り値

String 型。 可能な値は次のとおりです。

  • 'probably': 指定されたメディアタイプは再生可能なようです。
  • 'maybe': メディアタイプを再生せずに再生可能かどうかを判断できません。
  • ''（空の文字列）: 指定されたメディアタイプは絶対に再生できません。

注: 以前は canPlayType('video/webm') は 'probably' を返しました。 Gecko 28 (Firefox 28 / Thunderbird 28 / SeaMonkey 2.25 / Firefox OS 1.3) 以降では、'maybe' を返します。 (バグ 884275)

例

var obj = document.createElement('video');
console.log(obj.canPlayType('video/mp4')); // "maybe"

仕様

仕様 状態 コメント
HTML Living Standard
canplaytype の定義		 現行の標準  
HTML5
HTMLMediaElement.canplaytype の定義		 勧告 初期定義

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
canPlayType()Chrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 3.5
補足
完全対応 3.5
補足
補足 Prior to Firefox 28, canPlayType() returned probably when asked about WebM audio or video files without the codecs parameter. Since multiple codecs are supported, this is not enough information to determine if a file can be played, so maybe is now correctly returned.
IE 完全対応 9Opera 完全対応 ありSafari 完全対応 6WebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 ありOpera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応
実装ノートを参照してください。
実装ノートを参照してください。

関連情報