PerformanceElementTiming: naturalHeight property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The naturalHeight read-only property of the PerformanceElementTiming interface returns the intrinsic height of the image element.
Value
An unsigned 32-bit integer (unsigned long) which is the intrinsic height of the image if this is applied to an image, 0 for text.
Examples
Logging naturalHeight
In this example an <img> element is being observed by adding the elementtiming attribute. A PerformanceObserver is registered to get all performance entries of type "element" and the buffered flag is used to access data from before observer creation. The image file has a width of 1000px and a height of 750px. Calling entry.naturalHeight returns 750, that being the intrinsic height in pixels.
<img
src="image.jpg"
alt="a nice image"
elementtiming="big-image"
id="myImage" />
const observer = new PerformanceObserver((list) => {
list.getEntries().forEach((entry) => {
if (entry.identifier === "big-image") {
console.log(entry.naturalHeight);
}
});
});
observer.observe({ type: "element", buffered: true });
Specifications
| Specification |
|---|
| Element Timing API # dom-performanceelementtiming-naturalheight |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
naturalHeight
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.