LargestContentfulPaint: size property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The size read-only property of the LargestContentfulPaint interface returns the intrinsic size of the element that is the largest contentful paint.

The size of the element is the width times height of the rectangle that this element creates on the screen.

Value

An integer representing the width times height of the element.

Examples

Logging the size of the largest contentful paint element

This example uses a PerformanceObserver notifying of new largest-contentful-paint performance entries as they are recorded in the browser's performance timeline. The buffered option is used to access entries from before the observer creation.

js
const observer = new PerformanceObserver((list) => {
  const entries = list.getEntries();
  const lastEntry = entries[entries.length - 1]; // Use the latest LCP candidate
  console.log(lastEntry.size);
});
observer.observe({ type: "largest-contentful-paint", buffered: true });

Specifications

Specification
Largest Contentful Paint
# dom-largestcontentfulpaint-size

Browser compatibility

BCD tables only load in the browser