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

An Element.

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