Performance: clearMarks() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

Note: This feature is available in Web Workers.

The clearMarks() method removes all or specific PerformanceMark objects from the browser's performance timeline.

Syntax

js
clearMarks()
clearMarks(name)

Parameters

name Optional

A string representing the name of the PerformanceMark object. If this argument is omitted, all entries with an entryType of "mark" will be removed.

Return value

None (undefined).

Examples

Removing markers

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

js
// Create a bunch of marks
performance.mark("login-started");
performance.mark("login-started");
performance.mark("login-finished");
performance.mark("form-sent");
performance.mark("video-loaded");
performance.mark("video-loaded");

performance.getEntriesByType("mark").length; // 6

// Delete just the "login-started" mark entries
performance.clearMarks("login-started");
performance.getEntriesByType("mark").length; // 4

// Delete all of the mark entries
performance.clearMarks();
performance.getEntriesByType("mark").length; // 0

Specifications

Specification
User Timing
# dom-performance-clearmarks

Browser compatibility

BCD tables only load in the browser

See also