Baseline Widely available
The PerformancePaintTiming
interface provides timing information about "paint" (also called "render") operations during web page construction. "Paint" refers to conversion of the render tree to on-screen pixels.
There are two key paint moments this API provides:
A third key paint moment is provided by the LargestContentfulPaint
API:
The data this API provides helps you minimize the time that users have to wait before they can see the site's content start to appear. Decreasing the time until these key paint moments make sites feel more responsive, performant, and engaging for your users.
Like other Performance APIs, this API extends PerformanceEntry
.
This interface has no properties but it extends the following PerformanceEntry
properties by qualifying and constraining the properties as follows:
PerformanceEntry.entryType
Returns "paint"
.
PerformanceEntry.name
Returns either "first-paint"
or "first-contentful-paint"
.
PerformanceEntry.startTime
Returns the timestamp
when the paint occurred.
PerformanceEntry.duration
Returns 0.
This interface has no methods.
Examples Getting paint timingsExample using a PerformanceObserver
, which notifies of new paint
performance entries as they are recorded in the browser's performance timeline. Use the buffered
option to access entries from before the observer creation.
const observer = new PerformanceObserver((list) => {
list.getEntries().forEach((entry) => {
console.log(
`The time to ${entry.name} was ${entry.startTime} milliseconds.`,
);
// Logs "The time to first-paint was 386.7999999523163 milliseconds."
// Logs "The time to first-contentful-paint was 400.6999999284744 milliseconds."
});
});
observer.observe({ type: "paint", buffered: true });
Example using Performance.getEntriesByType()
, which only shows paint
performance entries present in the browser's performance timeline at the time you call this method:
const entries = performance.getEntriesByType("paint");
entries.forEach((entry) => {
console.log(`The time to ${entry.name} was ${entry.startTime} milliseconds.`);
// Logs "The time to first-paint was 386.7999999523163 milliseconds."
// Logs "The time to first-contentful-paint was 400.6999999284744 milliseconds."
});
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3