PerformanceElementTiming: naturalWidth 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

naturalWidthPerformanceElementTiming 接口的一个只读属性,它返回图像元素的固有宽度。

一个无符号 32 位整数 (unsigned long),如果此属性应用于图像,则表示图像的固有宽度;如果应用于文本,则为 0

示例

记录 naturalWidth

在此示例中,通过添加 elementtiming 属性来观察一个 <img> 元素。注册一个 PerformanceObserver 以获取所有类型为 "element" 的性能条目,并使用 buffered 标志来访问观察者创建之前的数据。图像文件的宽度为 1000px,高度为 750px。调用 entry.naturalWidth 返回 1000,即以像素为单位的固有宽度。

html
<img
  src="image.jpg"
  alt="a nice image"
  elementtiming="big-image"
  id="myImage" />
js
const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    if (entry.identifier === "big-image") {
      console.log(entry.naturalWidth);
    }
  });
});
observer.observe({ type: "element", buffered: true });

规范

规范
Element Timing API
# dom-performanceelementtiming-naturalwidth

浏览器兼容性