MDN self-hosted library · e01.org

Performance: eventCounts property

Performance API

Open notebook · 1 cells web-api-instance-property upstream source

Performance API

The read-only performance.eventCounts property is an EventCounts map containing the number of events which have been dispatched per event type since the page was loaded.

Not all event types are exposed. You can only get counts for event types supported by the PerformanceEventTiming interface.

Value

An EventCounts map. (A read-only Map without the clear(), delete(), and set() methods).

Examples

Reporting event types and their counts

If you like to send event counts to your analytics, you may want to implement a function like sendToEventAnalytics which takes the event counts from the performance.eventCounts map and then uses the Fetch API to post the data to your endpoint.

// Report all exposed events
for (const [type, count] of performance.eventCounts.entries()) {
  // sendToEventAnalytics(type, count);
}

// Report a specific event
const clickCount = performance.eventCounts.get("click");
// sendToEventAnalytics("click", clickCount);

// Check if an event count is exposed for a type
const isExposed = performance.eventCounts.has("mousemove"); // false

Specifications

Browser compatibility

See also

  • EventCounts
  • PerformanceEventTiming
  • Map