Performance

The Performance interface represents timing-related performance information for the given page.

An object of this type can be obtained by calling the Window.performance (en-US) read-only attribute.

Note: This interface and its members are available in Web Workers, except where indicated below. Note that some available parts of the interface are not yet documented (see the Performance Timeline and User Timing specs for more details.) Also note that performance markers and measures are per context. If you create a mark on the main thread (or other worker), you cannot see it in a worker thread, and vice versa.

Properties

The Performance interface doesn't inherit any properties.

Performance.navigation (en-US) Read only

Is a PerformanceNavigation (en-US) object representing the type of navigation that occurs in the given browsing context, like the amount of redirections needed to fetch the resource. Not available in workers.

Performance.onframetimingbufferfull

TBD

Performance.onresourcetimingbufferfull (en-US)

Is an EventTarget which is a callback that will be called when the resourcetimingbufferfull event is fired.

Performance.timing (en-US) Read only

Is a PerformanceTiming (en-US) object containing latency-related performance information. Not available in workers.

Methods

_The Performance interface doesn't inherit any method_.

Performance.clearFrameTimings()

TBD

Performance.clearMarks() (en-US)

Removes the given mark from the browser's performance entry buffer.

Performance.clearMeasures() (en-US)

Removes the given measure from the browser's performance entry buffer.

Performance.clearResourceTimings() (en-US)

Removes all performance entries with a entryType (en-US) of "resource" from the browser's performance data buffer.

Performance.getEntries() (en-US)

Returns a list of PerformanceEntry objects based on the given filter.

Performance.getEntriesByName() (en-US)

Returns a list of PerformanceEntry objects based on the given name and entry type.

Performance.getEntriesByType() (en-US)

Returns a list of PerformanceEntry objects of the given entry type.

Performance.mark()

Creates a timestamp (en-US) in the browser's performance entry buffer with the given name.

Performance.measure() (en-US)

Creates a named timestamp (en-US) in the browser's performance entry buffer between two specified marks (known as the start mark and end mark, respectively).

Performance.now()

Returns a DOMHighResTimeStamp (en-US) representing the amount of milliseconds elapsed since a reference instant.

Performance.setFrameTimingBufferSize()

TBD

Performance.setResourceTimingBufferSize() (en-US)

Sets the browser's resource timing buffer size to the specified number of "resource" type (en-US) performance entry objects.

Performance.toJSON() (en-US)

Is a jsonizer returning a json object representing the Performance object.

Specifications

Specification
High Resolution Time
# sec-performance
Performance Timeline
# extensions-to-the-performance-interface
Resource Timing
# sec-extensions-performance-interface
User Timing
# extensions-performance-interface

Browser compatibility

BCD tables only load in the browser