W3cubDocs

/Web APIs

Performance

The Performance interface provides access to performance-related information for the current page.

An object of this type can be obtained by calling window.performance or self.performance in workers. Note that Performance entries 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. See self.performance for which APIs are available in window and worker contexts.

EventTarget Performance

Instance properties

The Performance interface doesn't inherit any properties.

Performance.eventCounts Read only

An EventCounts map containing the number of events which have been dispatched per event type.

Performance.navigation Read only Deprecated

A legacy PerformanceNavigation object that provides useful context about the operations included in the times listed in timing, including whether the page was a load or a refresh, how many redirections occurred, and so forth.

Performance.timing Read only Deprecated

A legacy PerformanceTiming object containing latency-related performance information.

Performance.memory Read only Non-standard Deprecated

A non-standard extension added in Chrome, this property provides an object with basic memory usage information. You should not use this non-standard API.

Performance.timeOrigin Read only

Returns the high resolution timestamp of the start time of the performance measurement.

Instance methods

The Performance interface doesn't inherit any methods.

Performance.clearMarks()

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

Performance.clearMeasures()

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

Performance.clearResourceTimings()

Removes all performance entries with a entryType of "resource" from the browser's performance data buffer.

Performance.getEntries()

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

Performance.getEntriesByName()

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

Performance.getEntriesByType()

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

Performance.mark()

Creates a timestamp in the browser's performance entry buffer with the given name.

Performance.measure()

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

Performance.measureUserAgentSpecificMemory() Experimental

Estimates the memory usage of a web application including all its iframes and workers.

Performance.now()

Returns a DOMHighResTimeStamp representing the number of milliseconds elapsed since a reference instant.

Performance.setResourceTimingBufferSize()

Sets the browser's resource timing buffer size to the specified number of "resource" type performance entry objects.

Performance.toJSON()

Returns a JSON representation of the Performance object.

Events

Listen to these events using addEventListener() or by assigning an event listener to the oneventname property of this interface.

resourcetimingbufferfull

Fired when the browser's resource timing buffer is full.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
Performance 6 12 7 9 15 8 ≤37 18 7 14 9 1.0
clearMarks 2925–29 12 38 10 33 11 4.4 2925–29 42 33 11 2.01.5–2.0
clearMeasures 2925–29 12 38 10 33 11 4.4 2925–29 42 33 11 2.01.5–2.0
clearResourceTimings 4622–57 12 35 10 3315–44 11 464.4–57 4625–57 35 3314–43 11 5.01.5–7.0
eventCounts 85 85 89 No 71 No 85 85 89 60 No 14.0
getEntries 2825–36 12 35 10 No 11 4.4 2825–36 35 No 11 1.51.5–3.0
getEntriesByName 2825–36 12 35 10 No 11 4.4 2825–36 35 No 11 1.51.5–3.0
getEntriesByType 2825–36 12 35 10 1515–23 11 4.4 2825–36 35 1514–24 11 1.51.5–3.0
mark 2825–28 12 38 10 33 11 4.4 2825–28 42 33 11 1.5
measure 2825–28 12 38 10 33 11 4.4 2825–28 42 33 11 1.5
measureUserAgentSpecificMemory 89 89 No No 75 No 89 89 No 63 No 15.0
memory 7 79 No No 15 No ≤37 18 No 14 No 1.0
navigation 10 12 7 9 15 8 ≤37 18 7 No 9 1.0
now 2421–24 12
15["In Firefox 57.0.4 the accuracy was reduced to 20 microseconds.", "In Firefox 59 the accuracy was reduced to 2 milliseconds.", "In Firefox 60 the accuracy was increased to 1 millisecond."]
10 15 8 4.4 25
15["In Firefox 57.0.4 the accuracy was reduced to 20 microseconds.", "In Firefox 59 the accuracy was reduced to 2 milliseconds.", "In Firefox 60 the accuracy was increased to 1 millisecond."]
14 9 1.5
resourcetimingbufferfull_event 4622–57 79 35 No No 11 464.4–57 4625–57 35 3314–43 11 5.01.5–7.0
setResourceTimingBufferSize 4622–57 12 35 10 3315–44 11 464.4–57 4625–57 35 3314–43 11 5.01.5–7.0
timeOrigin 62 16 53 No 49 15 62 62 53 46 15 8.0
timing 6 12 7 9 15 8 ≤37 18 7 14 9 1.0
toJSON 56 12 25 9 No 14.1 56 56 25 No 14.5 6.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Performance