performance.clearMarks()

clearMarks() メソッドは、ブラウザーのパフォーマンスエントリーバッファーから名前付きマークを削除します。このメソッドが引数なしで呼び出された場合、エントリー種別が "mark" のパフォーマンスエントリーがすべてパフォーマンスエントリーバッファーから削除されます。

注: この機能は Web Worker 内で利用可能です

構文

js

performance.clearMarks();
performance.clearMarks(name);

引数

name 省略可

タイムスタンプの名前を表す DOMString です。 この引数を省略すると、エントリー種別が "mark" であるすべてのパフォーマンスエントリーが削除されます。

返値

  • void
    • :

次の例は、clearMarks() メソッドの両方の使用法を示しています。

js

// PerformanceMark のエントリーがいくつあるかを表示する小さなヘルパーを作成します。
function logMarkCount() {
  console.log(
    "Found this many entries: " + performance.getEntriesByType("mark").length,
  );
}

// Create a bunch of marks.
performance.mark("squirrel");
performance.mark("squirrel");
performance.mark("monkey");
performance.mark("monkey");
performance.mark("dog");
performance.mark("dog");

logMarkCount(); // "Found this many entries: 6"

// Delete just the "squirrel" PerformanceMark entries.
performance.clearMarks("squirrel");
logMarkCount(); // "Found this many entries: 4"

// Delete all of the PerformanceMark entries.
performance.clearMarks();
logMarkCount(); // "Found this many entries: 0"

仕様書

Specification
User Timing
# dom-performance-clearmarks

ブラウザーの互換性

BCD tables only load in the browser