The PaintTiming plugin collects paint metrics exposed by the W3C Paint Timing and Largest Contentful Paint specifications.
For information on how to include this plugin, see the Building tutorial.
Beacon Parameters
All beacon parameters are prefixed with pt.
.
This plugin adds the following parameters to the beacon:
pt.fp
:first-paint
inDOMHighResTimestamp
pt.fcp
:first-contentful-paint
inDOMHighResTimestamp
pt.lcp
:largest-contentful-paint
inDOMHighResTimestamp
pt.hid
: The document was loaded hidden (at some point), so FP and FCP are user-driven events, and thus won't be added to the beacon.pt.lcp.src
: Source URL of the Largest Contentful Paint elementpt.lcp.el
: Element tag name of the Largest Contentful Paintpt.lcp.id
: Element ID of the Largest Contentful Paintpt.lcp.e
: Element Pseudo-CSS selector for the Largest Contentful Paintpt.lcp.srcset
: Element srcset property of the Largest Contentful Paintpt.lcp.sizes
: Element sizes property of the Largest Contentful Paintpt.lcp.s
: Size of the Largest Contentful Paint in device-independent pixels squared
Methods
-
getTimingFor(timingName)
-
Gets the PaintTiming timestamp for the specified name
Parameters:
Name Type Description timingName
string PaintTiming name
Returns:
Type: DOMHighResTimestamp
Timestamp
-
init()
-
Initializes the plugin.
This plugin does not have any configuration.
Returns:
BOOMR.plugins.PaintTiming
The PaintTiming plugin for chaining -
is_complete()
-
Whether or not this plugin is complete
Returns:
Type: boolean
true
if the plugin is complete -
is_enabled()
-
Whether or not this plugin is enabled and PaintTiming is supported.
Returns:
Type: boolean
true
if PaintTiming plugin is enabled and supported. -
is_supported()
-
Whether or not PaintTiming is supported in this browser.
Returns:
Type: boolean
true
if PaintTiming is supported.