Add interactionCount docs

files/en-us/glossary/interaction_to_next_paint/index.md

@@ -14,14 +14,15 @@ INP was designed by Google as one of the [Core Web Vital](https://web.dev/articl
 
 INP measures the worst length of time (minus some outliers), in milliseconds, between the user interaction on a web page and the next frame presentation after that interaction is processed. Scrolling and zooming are not included in this metric. INP is calculated using the [Event Timing API](/en-US/docs/Web/API/PerformanceEventTiming). Asynchronous operations such as network fetches or file reads usually do not delay INP as painting can occur while such operations are handled.
 
-All eligible interactions throughout the page lifetime are considered. For highly interactive pages of 50 or more interactions, the 98th percentile is used to exclude some extreme outliers that are not reflective of overall page responsiveness.
+All eligible interactions throughout the page lifetime are considered. For highly interactive pages of 50 or more interactions, the 98th percentile is used to exclude some extreme outliers that are not reflective of overall page responsiveness. The {{domxref("Performance.interactionCount")}} value can be used to see when a large number of interactions have happened on a page.
 
 The longer the delay, the worse the user experience. The [Long Animation Frames API](/en-US/docs/Web/API/Performance_API/Long_animation_frame_timing) can help identify causes of high INP.
 
 ## See also
 
 - [Long animation frame timing](/en-US/docs/Web/API/Performance_API/Long_animation_frame_timing)
 - [PerformanceEventTiming](/en-US/docs/Web/API/PerformanceEventTiming)
+- {{domxref("Performance.interactionCount")}}
 - [INP](https://web.dev/articles/inp) on web.dev (2023)
 - [Optimize Interaction to Next Paint](https://web.dev/articles/optimize-inp) on web.dev (2023)
 - [Interaction to Next Paint is officially a Core Web Vital](https://web.dev/blog/inp-cwv-launch) on web.dev (2024)

files/en-us/web/api/performance/index.md

@@ -19,13 +19,12 @@ _The `Performance` interface doesn't inherit any properties._
 
 - {{domxref("Performance.eventCounts")}} {{ReadOnlyInline}}
   - : An {{domxref("EventCounts")}} map containing the number of events which have been dispatched per event type.
-
+- {{domxref("Performance.interactionCount")}} {{ReadOnlyInline}}
+  - : A count of the number of real-user interactions that have occurred on the page, which is useful to accurately calculate {{Glossary("Interaction_to_next_paint", "Interaction to Next Paint (INP)")}}.
 - {{domxref("Performance.navigation")}} {{ReadOnlyInline}} {{Deprecated_Inline}}
   - : A legacy {{domxref("PerformanceNavigation")}} object that provides useful context about the operations included in the times listed in `timing`, including whether the page was a load or a refresh, how many redirections occurred, and so forth.
-
 - {{domxref("Performance.timing")}} {{ReadOnlyInline}} {{Deprecated_Inline}}
   - : A legacy {{domxref("PerformanceTiming")}} object containing latency-related performance information.
-
 - {{domxref("Performance.memory")}} {{ReadOnlyInline}} {{Non-standard_Inline}} {{Deprecated_Inline}}
   - : A _non-standard_ extension added in Chrome, this property provides an object with basic memory usage information. _You **should not use** this non-standard API._
 - {{domxref("Performance.timeOrigin")}} {{ReadOnlyInline}}

files/en-us/web/api/performance/interactioncount/index.md

@@ -0,0 +1,45 @@
+---
+title: "Performance: interactionCount property"
+short-title: interactionCount
+slug: Web/API/Performance/interactionCount
+page-type: web-api-instance-property
+browser-compat: api.Performance.interactionCount
+---
+
+{{APIRef("Performance API")}}
+
+The read-only `performance.interactionCount` property is an `unsigned long` A count of the number of real-user interactions that have occurred on the page.
+
+Only discrete interactions with an {{domxref("PerformanceEventTiming.interactionId")}} are counted, so scroll interactions are excluded for example.
+
+This is useful to accurately calculate {{Glossary("Interaction_to_next_paint", "Interaction to Next Paint (INP)")}}, and in particular to exclude outliers for long-lived pages as INP takes the 98th percentile of interactions for a page and so excludes 1 in every 50 interactions as "outliers" that are not reflective of overall page responsiveness.
+
+## Value
+
+A number. Starting at `0` and increment with each discrete interaction as measured by {{domxref("PerformanceEventTiming")}} and where an {{domxref("PerformanceEventTiming.interactionId")}} is assigned.
+
+## Examples
+
+### Checking the number of interactions to accurately calculate INP
+
+```js
+// For pages with a large number of interactions, recalculate INP after
+// excluding 1 out of every 50 outliers.
+if (performance.interactionCount > 50) {
+  // (Actual calculation is complex and is not shown here)
+}
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- {{domxref("PerformanceEventTiming")}}
+- {{domxref("PerformanceEventTiming.interactionId")}}
+- {{Glossary("Interaction_to_next_paint", "Interaction to Next Paint (INP)")}}