大网数据广告活动
Web 标准与前端开发

HTMLMediaElement: preload property

· 52CE 我爱测

The **`preload`** property of the HTMLMediaElement interface is a string that provides a hint to the browser about what the author thinks will lead to the best user experience.

HTML DOM

The preload property of the HTMLMediaElement interface is a string that provides a hint to the browser about what the author thinks will lead to the best user experience.

It reflects the preload attribute of the audio element and the video element.

Value

A string. Possible values are as follows:

  • none
    • : Indicates that the media should not be preloaded.
  • metadata
    • : Indicates that only media metadata (e.g., length) is fetched.
  • auto
    • : Indicates that the whole media file can be downloaded, even if the user is not expected to use it.
  • empty string
    • : A synonym of the auto value.

Examples

<video
  id="el"
  controls
  src="https://example.com/media.mp4"
  poster="https://example.com/media.jpg"
  width="800"
  height="600"
  preload="metadata">
  Sorry, your browser doesn't support embedded videos, but don't worry, you can
  <a href="https://example.com/media.mp4" download="media.mp4">download it</a>
  and watch it with your favorite video player!
</video>
const el = document.getElementById("el");
console.log(el.preload); // Output: "metadata"

Specifications

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。