HTMLMediaElement.load()

HTMLMediaElementload() メソッドは、メディア要素をその初期状態にリセットし、再生を開始する準備としてメディアソースを選択してメディアを読み込むプロセスを開始します。 プリフェッチされるメディアデータの量は、要素の preload 属性の値によって決まります。

このメソッドは通常、要素の src 属性を変更するか、メディア要素自体の中にネストされている <source> 要素を追加または削除することによって、メディア要素に使用可能な一連のソースを動的に変更した場合にのみ役立ちます。 load() は要素をリセットして利用可能なソースを再スキャンし、それによって変更を有効にします。

構文

mediaElement.load();

パラメーター

無し。

戻り値

undefined

使用上の注意

load() を呼び出すと、このメディア要素を含む進行中のすべての操作が中止され、<audio> 要素または <video> 要素で指定されたオプションとその src 属性または子の <source> 要素を指定して適切なメディアリソースの選択と読み込みのプロセスが開始されます。 これについては、動画と音声のコンテンツ複数フォーマットのサポートで詳しく説明しています。

進行中のアクティビティを中止するプロセスにより、play() によって返された未処理の Promise が、新しいメディアの読み込みが開始される前に、そのステータスに基づいて適切に解決または拒否されます。 保留中の play の promises は "AbortError" DOMException で中止されます。

読み込みプロセスが進むにつれて、次のように適切なイベントがメディア要素自体に送信されます。

  • 要素がすでにメディアの読み込み処理中の場合、その読み込み処理は中止され、abort イベントが送信されます。
  • 要素がすでにメディアで初期化されている場合は、emptied イベントが送信されます。
  • 再生位置をメディアの先頭にリセットすると、実際に再生位置が変更された場合(つまり、まだ先頭になっていない場合)、timeupdate イベントが送信されます。
  • メディアが選択され、読み込みの開始準備が整うと、loadstart イベントが配信されます。
  • これ以降は、メディアの読み込みと同じようにイベントが送信されます。

この例では、ドキュメント内の <video> 要素を見つけて、load() を呼び出してそれをリセットします。

var mediaElem = document.querySelector("video");
mediaElem.load();

仕様

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

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
loadChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 3.6IE ? Opera 完全対応 ありSafari 完全対応 6WebView Android 完全対応 1Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明