大网数据广告活动
Web 标准与前端开发

InteractionContentfulPaint

· 52CE 我爱测

The `InteractionContentfulPaint` interface provides timing information about Contentful paint attributable to an interaction.

Performance API

The InteractionContentfulPaint interface provides timing information about Contentful paint attributable to an interaction.

Instance properties

This interface directly defines the following properties:

  • InteractionContentfulPaint.interactionId
    • : The id of the interaction that resulted in the paint.
  • InteractionContentfulPaint.largestContentfulPaint
    • : Returns details of the largest LargestContentfulPaint for the interaction. This can remain the same between two InteractionContentfulPaint entries for the same interaction if a new contentful paint is smaller than the current largest contentful paint for that interaction.
  • InteractionContentfulPaint.paintTime
    • : Returns the DOMHighResTimeStamp of when the first rendering phase ended and the paint phase started.
  • InteractionContentfulPaint.presentationTime
    • : Returns the DOMHighResTimeStamp of when the first painted pixels were actually drawn on the screen.

It also extends the following PerformanceEntry properties, qualifying and constraining them as described:

  • PerformanceEntry.entryType
    • : Returns "interaction-contentful-paint".
  • PerformanceEntry.duration
    • : Returns the result of InteractionContentfulPaint.presentationTime - PerformanceEntry.startTime.
  • PerformanceEntry.name
    • : Always returns an empty string.
  • PerformanceEntry.startTime
    • : Returns the DOMHighResTimeStamp of the interaction that resulted in the soft navigation.

Instance methods

  • InteractionContentfulPaint.toJSON()
    • : Returns a JSON-serializable plain object representing the InteractionContentfulPaint object. Automatically called by JSON.stringify().

Description

The InteractionContentfulPaint provides a stream of paint updates attributable to an interaction.

At present this is scoped to increasing paint sizes, so it can be used to measure Largest Contentful Paint for Soft Navigation, however the API has been designed to allow for all paints relevant to an interaction to be emitted.

InteractionContentfulPaint is needed instead of using the LargestContentfulPaint API, as that is only emitted per full page load and is finalized upon interaction (which is a necessary start to a soft navigation).

Using navigationId and interactionId

For Soft Navigation, paints happening before the URL is updated may be considered for the Largest Contentful Paint of the soft navigation that is in flight. For the LCP case, PerformanceSoftNavigation.getLargestInteractionContentfulPaint() and InteractionContentfulPaint.interactionId are more effective at considering all relevant paints regardless of the navigationId, when calculating that metric.

Relationship with Event Timing and INP

The Event Timing API provides details about UIEvents — scheduling and processing durations, and total duration to next paint — but does not directly track the effects of those events, nor any future paints those effects might cause. It is intended to measure the responsiveness time during which a user receives no feedback, which should be kept to a minimum and forms the basis for metrics such as Interaction to Next Paint.

InteractionContentfulPaint, despite being similarly named to Interaction to Next Paint, serves a different purpose. InteractionContentfulPaint excludes non-contentful paints, which do count for Event Timing and INP but also measures additional paints beyond the first paint. It enables measuring the effects and content updates directly attributable to an interaction, resulting in a better understanding of the associated performance implications.

Examples

Observing interaction contentful paints

In the following example, a PerformanceObserver is registered to get the interaction contentful paints. The buffered flag is used to access data from before observer creation.

const observer = new PerformanceObserver((list) => {
  for (const entry of list.getEntries()) {
    console.log("Interaction Contentful Paints:", entry.startTime, entry);
  }
});
observer.observe({ type: "interaction-contentful-paint", buffered: true });

Observing interaction contentful paints specific to a soft navigation

One of the key uses of the InteractionContentfulPaint interface is to measure all contentful paints related to a soft navigation to calculate the Largest Contentful Paint for that soft navigation.

To do this, it is recommended to use the PerformanceSoftNavigation.interactionId rather than the PerformanceEntry.navigationId, since some LCP candidates can happen before the soft navigation is defined (for paints, before the URL is updated) and will therefore have the old navigationId.

let currentNavigationInteractionId = 1045; // hardcoded in this example

const observer = new PerformanceObserver((list) => {
  for (const entry of list.getEntries()) {
    if (entry.interactionId === currentNavigationInteractionId) {
      console.log("Soft LCP candidate:", entry.startTime, entry);
    }
  }
});
observer.observe({ type: "interaction-contentful-paint", buffered: true });

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。