blob: 74e2435288e4fb4568372aa457845a7a63502313 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
---
title: performance.mark()
slug: Web/API/Performance/mark
tags:
- API
- メソッド
- リファレンス
- ウェブパフォーマンス
browser-compat: api.Performance.mark
translation_of: Web/API/Performance/mark
---
{{APIRef("User Timing API")}}
**`mark()`** メソッドは、ブラウザーのパフォーマンスエントリーバッファーに、指定された名前で{{domxref("DOMHighResTimeStamp","timestamp")}} を作成します。
アプリケーション定義のタイムスタンプは、{{domxref("Performance")}} インタフェースの `getEntries*()` メソッド ({{domxref("Performance.getEntries","getEntries()")}}、{{domxref("Performance.getEntriesByName","getEntriesByName()")}} または{{domxref("Performance.getEntriesByType","getEntriesByType()")}}) のいずれかによって取得できます。
`mark()` は内部的にデータを {{domxref("PerformanceEntry")}} として格納します。
{{AvailableInWorkers}}
## 構文
```js
performance.mark(name);
performance.mark(measureName, markOptions)
```
### 引数
- name
- : {{domxref("DOMString")}} で、マークの名前を表します。このメソッドで指定された `name` がすでに {{domxref("PerformanceTiming")}} インターフェイスに存在していた場合は、 {{jsxref("SyntaxError")}} が発生します。
- `markOptions` {{optional_inline}}
- : このマークのためにタイムスタンプと追加のメタデータを指定するためのオブジェクトです。
- `detail`
- : マークに含める任意のメタデータです。
- `startTime`
- : マークの時刻として使用する {{domxref("DOMHighResTimeStamp")}} desu.
### 返値
- entry
- : 生成された {{domxref("PerformanceMark")}} エントリーです。
## 例
次の例は、`mark()` を使用して {{domxref("PerformanceMark")}} エントリーを作成および取得する方法を示しています。
```js
// たくさんの 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();
```
## 仕様書
{{Specifications}}
## ブラウザーの互換性
{{Compat}}
|
