Timing Entry Names Registry

W3C First Public Working Draft

This version:
https://www.w3.org/TR/2019/WD-timing-entrytypes-registry-20190723/
Latest published version:
https://www.w3.org/TR/timing-entrytypes-registry/
Latest editor's draft:
https://w3c.github.io/timing-entrytypes-registry/
Editor:
Philippe Le Hegaret (W3C)
Participate:
GitHub w3c/timing-entrytypes-registry
File a bug
Commit history
Pull requests

Abstract

This document provides a registry of PerformanceEntry.entryType used in Performance Timeline [PERFORMANCE-TIMELINE-2].

Status of This Document

This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.

For updates, see Registration Entry Requirements and Update Process.

This document was published by the Web Performance Working Group as a First Public Working Draft.

GitHub Issues are preferred for discussion of this specification.

Publication as a First Public Working Draft does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.

This document was produced by a group operating under the W3C Patent Policy. The group does not expect this document to become a W3C Recommendation. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.

This document is governed by the 1 March 2019 W3C Process Document.

1. Purpose

This section is non-normative.

Performance Timeline [PERFORMANCE-TIMELINE-2] defines primitives that enable web developers to access, instrument, and retrieve various performance metrics from the full lifecycle of a web application. The performance data of various metrics is hosted in PerformanceEntry objects. The type of interface for a PerformanceEntry object is identified with entryType.

This registry is intended to provide a central location for enumerating identified interface types of PerformanceEntry object.

2. Registration Entry Requirements and Update Process

An update to this registry is an addition, change or deletion of an identifier. 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.

3. 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 Public Specification(s) Requestor Contact
"mark" PerformanceMark True Infinite [USER-TIMING-2] W3C
"measure" PerformanceMeasure True Infinite [USER-TIMING-2] W3C
"navigation" PerformanceNavigationTiming True Infinite [NAVIGATION-TIMING-2] W3C
"resource" PerformanceResourceTiming True 250 [RESOURCE-TIMING-2] W3C
"longtask" PerformanceLongTaskTiming False 0 [LONGTASKS-1] W3C
"paint" PerformancePaintTiming True 2 [PAINT-TIMING] W3C
"element" PerformanceElementTiming False 150 [ELEMENT-TIMING] WICG
"event" PerformanceEventTiming False 150 [EVENT-TIMING] WICG
"first-input" PerformanceEventTiming True 1 [EVENT-TIMING] WICG
"layout-shift" LayoutShift False 150 [LAYOUT-INSTABILITY] WICG
"largest-contentful-paint" LargestContentfulPaint False 150 [LARGEST-CONTENTFUL-PAINT] WICG

A. References

A.1 Normative references

[ELEMENT-TIMING]
Element Timing API. WICG. cg-draft. URL: https://wicg.github.io/element-timing/
[EVENT-TIMING]
Event Timing API. WICG. cg-draft. URL: https://wicg.github.io/event-timing/
[hr-time-2]
High Resolution Time Level 2. Ilya Grigorik; James Simonsen; Jatinder Mann. W3C. 26 June 2019. W3C Candidate Recommendation. URL: https://www.w3.org/TR/hr-time-2/
[LARGEST-CONTENTFUL-PAINT]
Largest Contentful Paint. WICG. cg-draft. URL: https://wicg.github.io/largest-contentful-paint/
[LAYOUT-INSTABILITY]
Layout Instability. WICG. cg-draft. URL: https://wicg.github.io/layout-instability/
[LONGTASKS-1]
Long Tasks API 1. Shubhie Panicker; Ilya Grigorik; Domenic Denicola. W3C. 7 September 2017. W3C Working Draft. URL: https://www.w3.org/TR/longtasks-1/
[NAVIGATION-TIMING-2]
Navigation Timing Level 2. Ilya Grigorik; Tobin Titus; Jatinder Mann; Arvind Jain. W3C. 15 July 2019. W3C Working Draft. URL: https://www.w3.org/TR/navigation-timing-2/
[PAINT-TIMING]
Paint Timing 1. Shubhie Panicker. W3C. 7 September 2017. W3C Working Draft. URL: https://www.w3.org/TR/paint-timing/
[PERFORMANCE-TIMELINE-2]
Performance Timeline Level 2. Ilya Grigorik. W3C. 26 June 2019. W3C Working Draft. URL: https://www.w3.org/TR/performance-timeline-2/
[RESOURCE-TIMING-2]
Resource Timing Level 2. Todd Reifsteck; Ilya Grigorik; Yoav Weiss; Arvind Jain; Jatinder Mann; Zhiheng Wang; Anderson Quach. W3C. 26 June 2019. W3C Working Draft. URL: https://www.w3.org/TR/resource-timing-2/
[USER-TIMING-2]
User Timing Level 2. Ilya Grigorik. W3C. 26 February 2019. W3C Recommendation. URL: https://www.w3.org/TR/user-timing-2/