From e8ec59b1086fa7c5f58c7482c4dcfd6fb7bd648b Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 22 Feb 2022 22:55:31 +0900 Subject: 2022/02/18 時点の英語版に同期 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/ja/web/api/performance/mark/index.md | 101 ++++++++++++----------------- 1 file changed, 40 insertions(+), 61 deletions(-) (limited to 'files/ja/web/api/performance/mark') diff --git a/files/ja/web/api/performance/mark/index.md b/files/ja/web/api/performance/mark/index.md index 1a02bd4154..74e2435288 100644 --- a/files/ja/web/api/performance/mark/index.md +++ b/files/ja/web/api/performance/mark/index.md @@ -3,52 +3,53 @@ title: performance.mark() slug: Web/API/Performance/mark tags: - API - - Webパフォーマンス - メソッド - リファレンス + - ウェブパフォーマンス +browser-compat: api.Performance.mark translation_of: Web/API/Performance/mark --- -
{{APIRef("User Timing API")}}
+{{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("DOMHighResTimeStamp","timestamp")}} を作成します。 -

{{AvailableInWorkers}}

+アプリケーション定義のタイムスタンプは、{{domxref("Performance")}} インタフェースの `getEntries*()` メソッド ({{domxref("Performance.getEntries","getEntries()")}}、{{domxref("Performance.getEntriesByName","getEntriesByName()")}} または{{domxref("Performance.getEntriesByType","getEntriesByType()")}}) のいずれかによって取得できます。 -

mark の {{domxref("PerformanceEntry","performance entry")}} は、次のプロパティ値を持ちます。

+`mark()` は内部的にデータを {{domxref("PerformanceEntry")}} として格納します。 - +{{AvailableInWorkers}} -

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

+## 構文 -

構文

+```js +performance.mark(name); +performance.mark(measureName, markOptions) +``` -
performance.mark(name);
-
+### 引数 -

引数

+- name + - : {{domxref("DOMString")}} で、マークの名前を表します。このメソッドで指定された `name` がすでに {{domxref("PerformanceTiming")}} インターフェイスに存在していた場合は、 {{jsxref("SyntaxError")}} が発生します。 -
-
name
-
マークの名前を表す {{domxref("DOMString")}}。
-
+- `markOptions` {{optional_inline}} + - : このマークのためにタイムスタンプと追加のメタデータを指定するためのオブジェクトです。 -

戻り値

+ - `detail` + - : マークに含める任意のメタデータです。 + - `startTime` + - : マークの時刻として使用する {{domxref("DOMHighResTimeStamp")}} desu. -
-
void
-
 
-
+### 返値 -

例

+- entry + - : 生成された {{domxref("PerformanceMark")}} エントリーです。 -

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

+## 例 -
// たくさんの mark を作成します。
+次の例は、`mark()` を使用して {{domxref("PerformanceMark")}} エントリーを作成および取得する方法を示しています。
+
+```js
+// たくさんの mark を作成します。
 performance.mark("squirrel");
 performance.mark("squirrel");
 performance.mark("monkey");
@@ -56,46 +57,24 @@ performance.mark("monkey");
 performance.mark("dog");
 performance.mark("dog");
 
-// PerformanceMark エントリをすべて取得します。
+// PerformanceMark エントリーをすべて取得します。
 const allEntries = performance.getEntriesByType("mark");
 console.log(allEntries.length);
 // 6
 
-// "monkey" PerformanceMark エントリをすべて入手します。
+// "monkey" PerformanceMark エントリーをすべて入手します。
 const monkeyEntries = performance.getEntriesByName("monkey");
 console.log(monkeyEntries.length);
 // 2
 
 // すべての mark を消去します。
 performance.clearMarks();
-
- -

仕様

- - - - - - - - - - - - - - - - - - - -
仕様書ステータスコメント
{{SpecName('User Timing Level 2', '#dom-performance-mark', 'mark()')}}{{Spec2('User Timing Level 2')}} -

mark() 処理モデルを明確にします。

-
{{SpecName('User Timing', '#dom-performance-mark', 'mark()')}}{{Spec2('User Timing')}}基本的な定義
- -

ブラウザの互換性

- -
-

{{Compat("api.Performance.mark")}}

-
+``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} -- cgit v1.2.3-54-g00ecf