HTMLMediaElement: preload プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

preload は HTMLMediaElement インターフェイスのプロパティで、製作者がどうすればもっとも使い勝手が良くなると考えているかについて、ブラウザーに与えるヒントを示す文字列です。

これは <audio> 要素と <video> 要素の preload 属性を反映しています。

値

文字列です。取りうる値は次の通りです。

none: このメディアを事前読み込みすべきではないことを示します。
metadata: メディアのメタデータ（長さなど）のみを取得することを示します。
auto: ユーザーが使用する予定がなくても、メディアファイル全体をダウンロードすることができることを示します。
空文字列: auto の値の別名です。

例

html

<video
  id="el"
  controls
  src="https://example.com/media.mp4"
  poster="https://example.com/media.jpg"
  width="800"
  height="600"
  preload="metadata">
  申し訳ありませんが、お使いのブラウザーは埋め込み動画に対応していません。<a href="https://example.com/media.mp4" download="media.mp4">ダウンロードする</a>ことで、お好きな動画プレイヤーでご覧いただけますのでご安心ください！
</video>

const el = document.getElementById("el");
console.log(el.preload); // 出力: "metadata"

仕様書

Specification
HTML Standard # dom-media-preload

ブラウザーの互換性

BCD tables only load in the browser