HTMLMediaElement: load() メソッド

構文

引数

なし。

返値

なし (undefined)。

使用上のメモ

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

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

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

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

例

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

仕様書

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.