Performance: clearMeasures() method

{{APIRef("Performance API")}}{{AvailableInWorkers}}

The clearMeasures() method removes all or specific {{domxref("PerformanceMeasure")}} objects from the browser's performance timeline.

Syntax

clearMeasures()
clearMeasures(name)

Parameters

• name {{optional_inline}}
  • : A string representing the {{domxref("PerformanceEntry.name", "name")}} of the {{domxref("PerformanceMeasure")}} object. If this argument is omitted, all entries with an {{domxref("PerformanceEntry.entryType","entryType")}} of "measure" will be removed.

Return value

None ({{jsxref("undefined")}}).

Examples

Removing measures

To clean up all performance measure, or just specific entries, use the clearMeasures() method like this:

// Create a bunch of measures
performance.measure("from navigation");
performance.mark("a");
performance.measure("from mark a", "a");
performance.measure("from navigation");
performance.measure("from mark a", "a");
performance.mark("b");
performance.measure("between a and b", "a", "b");

performance.getEntriesByType("measure").length; // 5

// Delete just the "from navigation" measure entries
performance.clearMeasures("from navigation");
performance.getEntriesByType("measure").length; // 3

// Delete all of the measure entries
performance.clearMeasures();
performance.getEntriesByType("measure").length; // 0

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{domxref("PerformanceMeasure")}}