LargestContentfulPaint: element property

Limited availability

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

The element read-only property of the LargestContentfulPaint interface returns an object representing the Element that is the largest contentful paint.

Value

Examples

Logging 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.element);
});
observer.observe({ type: "largest-contentful-paint", buffered: true });

Specifications

Specification
Largest Contentful Paint
# dom-largestcontentfulpaint-element

Browser compatibility

BCD tables only load in the browser