Timing Entry Names Registry

Registration Entry Requirements and Update Process

Each entry type must include a unique identifier used by PerformanceEntry.entryType, where the scope of uniqueness is the entryType itself.
Each entry type should include a link that references a public available specification (PAS) that defines the associated interface type.
Each entry type must include contact information of the requestor.
Each entry type must include an availableFromTimeline boolean indicating whether this entry type is available from the Performance interface.
Each entry type must include a maxBufferSize indicating the maximum buffer size for this entry type.
Each entry type must specify an algorithm should add entry which, given a {{PerformanceEntry}} |entry| of the entry type and optionally a PerformanceObserverInit |options| of an observer observing that entry type, determines the following:
1. If |options| was not provided, whether |entry| is eligible to be added to the performance timeline, regardless of limitations in the buffer size.
2. Otherwise, given registered performance observer |regObs| containing |options| in its options list, whether |entry| must be appended to |regObs|'s observer's observer buffer.

An update to this registry is one of the following:

An addition or deprecation of an identifier. Removal of identifiers is strongly discouraged.
An addition, change, or removal of a column to the table. The column containing identifiers must not be removed or changed.

Any person can request an update to this registry by pull requests to the timing-entrytypes-registry repository. The Web Performance Working Group will place it on an upcoming meeting agenda and notify the requestor. Consideration and disposition of the request is by consensus of the W3C Web Performance Working Group. The Chair will then notify the requestor of the outcome and update the registry accordingly.

Registry

This section is the registry of identified PerformanceEntry.entryType values for performance timeline interfaces [[PERFORMANCE-TIMELINE-2]].

`entryType` Identifier	Interface Type(s)	availableFromTimeline	maxBufferSize	Should add entry	Public Specification(s)	Requestor Contact
`"mark"`	`PerformanceMark`	`True`	`Infinite`	Return true	[[!USER-TIMING-2]]	W3C
`"measure"`	`PerformanceMeasure`	`True`	`Infinite`	Return true	[[!USER-TIMING-2]]	W3C
`"navigation"`	`PerformanceNavigationTiming`	`True`	`Infinite`	Return true	[[!NAVIGATION-TIMING-2]]	W3C
`"resource"`	`PerformanceResourceTiming`	`True`	`250`	Return true	[[!RESOURCE-TIMING-2]]	W3C
`"longtask"`	`PerformanceLongTaskTiming`	`False`	`200`	Return true	[[!LONGTASKS-1]]	W3C
`"paint"`	`PerformancePaintTiming`	`True`	`2`	Return true	[[!PAINT-TIMING]]	W3C
`"element"`	`PerformanceElementTiming`	`False`	`150`	Return true	[[!ELEMENT-TIMING]]	WICG
`"event"`	`PerformanceEventTiming`	`False`	`150`	Should add PerformanceEventTiming	[[!EVENT-TIMING]]	WICG
`"first-input"`	`PerformanceEventTiming`	`True`	`1`	Should add PerformanceEventTiming	[[!EVENT-TIMING]]	WICG
`"layout-shift"`	`LayoutShift`	`False`	`150`	Return true	[[!LAYOUT-INSTABILITY]]	WICG
`"largest-contentful-paint"`	`LargestContentfulPaint`	`False`	`150`	Return true	[[!LARGEST-CONTENTFUL-PAINT]]	WICG
`"long-animation-frame"`	`PerformanceLongAnimationFrameTiming`	`True`	`200`	Return true	[[!LONGTASKS-1]]	W3C

Purpose

Registration Entry Requirements and Update Process

Registry