PerformanceElementTiming: naturalWidth 属性

实验性： 这是一个 实验性技术
在生产环境中使用此功能之前，请仔细检查 浏览器兼容性表。

naturalWidth 是 PerformanceElementTiming 接口的只读属性，它返回图像元素的固有宽度。

值

一个无符号 32 位整数（无符号长整数），如果应用于图像，则表示图像的固有宽度，对于文本则为 0。

示例

记录 naturalWidth

在此示例中，一个 <img> 元素通过添加 elementtiming 属性进行观察。注册一个 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 });

规范

规范
元素计时 API
# ref-for-dom-performanceelementtiming-naturalwidth

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。