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

HTMLMediaElement:readyState 属性

· 52CE 我爱测

`HTMLMediaElement.readyState`** 属性返回媒体的就绪状态。

HTML DOM

HTMLMediaElement.readyState 属性返回媒体的就绪状态。

返回值

一个数字,为 HTMLMediaElement 接口上定义的五个可能的状态常量之一:

  • HTMLMediaElement.HAVE_NOTHING(0)
    • : 没有可用的关于媒体资源的信息。
  • HTMLMediaElement.HAVE_METADATA(1)
    • : 已检索到足够的媒体资源,元数据属性已经初始化。查询操作将不再引发异常。
  • HTMLMediaElement.HAVE_CURRENT_DATA(2)
    • : 当前播放位置的数据已经可用,但不足以实际播放多个帧。
  • HTMLMediaElement.HAVE_FUTURE_DATA(3)
    • : 当前播放位置和提供至少一小段时间的数据已经可用(换句话说,至少有两个视频帧)。
  • HTMLMediaElement.HAVE_ENOUGH_DATA(4)
    • : 有足够的数据可用,并且下载速度足够高,因此媒体可以不间断地播放到最后。

示例

这个示例将会监听一个 id 为 example 的音频数据的加载。它会检查当前播放位置是否已加载。如果是,则会播放音频。

<audio id="example" preload="auto">
  <source src="sound.ogg" type="audio/ogg" />
</audio>
const obj = document.getElementById("example");

obj.addEventListener("loadeddata", () => {
  if (obj.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA) {
    obj.play();
  }
});

规范

浏览器兼容性

参见

  • HTMLMediaElement:用于定义 HTMLMediaElement.readyState 属性的接口

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

资料来源与适用范围

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

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

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