performance.mark()

mark() メソッドは、ブラウザのパフォーマンスエントリバッファに、指定された名前でtimestamp を作成します。アプリケーション定義のタイムスタンプは、Performance インタフェースの getEntries*() メソッド (getEntries()、getEntriesByName() またはgetEntriesByType()) のいずれかによって取得できます。

mark の performance entry は、次のプロパティ値を持ちます。

• entryType - "mark" に設定されます
• name - mark が作成されたときに与えられた "name" に設定されます
• startTime - mark() が呼び出されたときに timestamp に設定されます
• duration -  "0" に設定します (mark には長さがありません)

このメソッドに与えられた name が PerformanceTiming インターフェイスにすでに存在する場合、SyntaxError がスローされます。

performance.mark(name);

name

マークの名前を表す DOMString。

void

 

次の例は、mark() を使用して PerformanceMark エントリを作成および取得する方法を示しています。

// たくさんの mark を作成します。
performance.mark("squirrel");
performance.mark("squirrel");
performance.mark("monkey");
performance.mark("monkey");
performance.mark("dog");
performance.mark("dog");

// PerformanceMark エントリをすべて取得します。
const allEntries = performance.getEntriesByType("mark");
console.log(allEntries.length);
// 6

// "monkey" PerformanceMark エントリをすべて入手します。
const monkeyEntries = performance.getEntriesByName("monkey");
console.log(monkeyEntries.length);
// 2

// すべての mark を消去します。
performance.clearMarks();