HTMLMediaElement：loadedmetadata 事件

基线

广泛可用

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

loadedmetadata 事件在元数据加载完成后触发。

语法

在类似 addEventListener() 的方法中使用事件名，或者设置事件处理器属性。

addEventListener("loadedmetadata", (event) => { })

onloadedmetadata = (event) => { }

通用 Event。

这些示例为 HTMLMediaElement 的 loadedmetadata 事件添加事件监听器，并在该事件处理器响应事件触发时发送一条消息。

使用 addEventListener()：

const video = document.querySelector("video");

video.addEventListener("loadedmetadata", (event) => {
  console.log("现已获知媒体的时长、尺寸和轨道。");
});

使用 onloadedmetadata 事件处理器属性：

const video = document.querySelector("video");

video.onloadedmetadata = (event) => {
  console.log("现已获知媒体的时长、尺寸和轨道。");
};

规范
HTML # event-media-loadedmetadata
HTML # handler-onloadedmetadata

此页面最后更新于 2026年9月19日，由 MDN 贡献者更新。