initial commit

1 files changed, 103 insertions, 0 deletions

diff --git a/files/ja/web/api/performance/mark/index.html b/files/ja/web/api/performance/mark/index.html
new file mode 100644
index 0000000000..d22500449c
--- /dev/null
+++ b/files/ja/web/api/performance/mark/index.html
@@ -0,0 +1,103 @@
+---
+title: performance.mark()
+slug: Web/API/Performance/mark
+tags:
+  - API
+  - Webパフォーマンス
+  - メソッド
+  - リファレンス
+translation_of: Web/API/Performance/mark
+---
+<div>{{APIRef("User Timing API")}}</div>
+
+<p><strong><code>mark()</code></strong> メソッドは、ブラウザの<em>パフォーマンスエントリバッファ</em>に、指定された名前で{{domxref("DOMHighResTimeStamp","timestamp")}} を作成します。アプリケーション定義のタイムスタンプは、{{domxref("Performance")}} インタフェースの <code>getEntries*()</code> メソッド ({{domxref("Performance.getEntries","getEntries()")}}、{{domxref("Performance.getEntriesByName","getEntriesByName()")}} または{{domxref("Performance.getEntriesByType","getEntriesByType()")}}) のいずれかによって取得できます。</p>
+
+<p>{{AvailableInWorkers}}</p>
+
+<p><code>mark</code> の {{domxref("PerformanceEntry","performance entry")}} は、次のプロパティ値を持ちます。</p>
+
+<ul>
+ <li>{{domxref("PerformanceEntry.entryType","entryType")}} - "<code>mark</code>" に設定されます</li>
+ <li>{{domxref("PerformanceEntry.name","name")}} - mark が作成されたときに与えられた "<code>name</code>" に設定されます</li>
+ <li>{{domxref("PerformanceEntry.startTime","startTime")}} - <code>mark()</code> が呼び出されたときに {{domxref("DOMHighResTimeStamp","timestamp")}} に設定されます</li>
+ <li>{{domxref("PerformanceEntry.duration","duration")}} -  "<code>0</code>" に設定します (mark には<em>長さ</em>がありません)</li>
+</ul>
+
+<p>このメソッドに与えられた <code>name</code> が {{domxref("PerformanceTiming")}} インターフェイスにすでに存在する場合、{{jsxref("SyntaxError")}} がスローされます。</p>
+
+<h2 id="構文">構文</h2>
+
+<pre class="syntaxbox"><em>performance</em>.mark(name);
+</pre>
+
+<h3 id="引数">引数</h3>
+
+<dl>
+ <dt>name</dt>
+ <dd>マークの名前を表す {{domxref("DOMString")}}。</dd>
+</dl>
+
+<h3 id="戻り値">戻り値</h3>
+
+<dl>
+ <dt>void</dt>
+ <dd> </dd>
+</dl>
+
+<h2 id="例">例</h2>
+
+<p>次の例は、<code>mark()</code> を使用して {{domxref("PerformanceMark")}} エントリを作成および取得する方法を示しています。</p>
+
+<pre class="brush: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();
+</pre>
+
+<h2 id="仕様">仕様</h2>
+
+<table class="standard-table">
+ <tbody>
+  <tr>
+   <th scope="col">仕様書</th>
+   <th scope="col">ステータス</th>
+   <th scope="col">コメント</th>
+  </tr>
+  <tr>
+   <td>{{SpecName('User Timing Level 2', '#dom-performance-mark', 'mark()')}}</td>
+   <td>{{Spec2('User Timing Level 2')}}</td>
+   <td>
+    <p><code>mark()</code> 処理モデルを明確にします。</p>
+   </td>
+  </tr>
+  <tr>
+   <td>{{SpecName('User Timing', '#dom-performance-mark', 'mark()')}}</td>
+   <td>{{Spec2('User Timing')}}</td>
+   <td>基本的な定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="ブラウザの互換性">ブラウザの互換性</h2>
+
+<div>
+<div class="hidden">このページの互換性テーブルは構造化データから生成されます。データに貢献したい場合は、<a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> して、プルリクエストを送ってください。</div>
+
+<p>{{Compat("api.Performance.mark")}}</p>
+</div>