diff options
Diffstat (limited to 'files/ja/web/api/performance/index.html')
| -rw-r--r-- | files/ja/web/api/performance/index.html | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/files/ja/web/api/performance/index.html b/files/ja/web/api/performance/index.html new file mode 100644 index 0000000000..ac6a83dc42 --- /dev/null +++ b/files/ja/web/api/performance/index.html @@ -0,0 +1,134 @@ +--- +title: Performance +slug: Web/API/Performance +tags: + - API + - Web パフォーマンス + - インターフェイス + - ナビゲーションタイミング + - パフォーマンス + - リファレンス +translation_of: Web/API/Performance +--- +<p>{{APIRef("High Resolution Time")}}</p> + +<p><strong><code>Performance</code></strong> インターフェイスは、現在のページのパフォーマンス関連情報へのアクセスを提供します。これはHigh Resolution Time API の一部ですが、Performance Timeline API、Navigation Timing API、User Timing API、および Resource Timing API によって拡張されています。</p> + +<p>このタイプのオブジェクトは読み取り専用属性 {{domxref("window.performance")}} を呼び出すことで取得できます。</p> + +<div class="note"> +<p><strong><em>メモ</em>: </strong>このインターフェイスとそのメンバーは、以下に示されている場合を除き、<a href="/ja/docs/Web/API/Web_Workers_API">Web Workers</a> で利用可能です。 パフォーマンスマーカーと測定値はコンテキストごとにあることにも注意してください。メインスレッド (または他のワーカー) にマークを作成した場合、それを Worker スレッドには表示できません (その逆も同様)。</p> +</div> + +<h2 id="プロパティ">プロパティ</h2> + +<p><em><code>Performance</code> インターフェイスはプロパティを継承しません。</em></p> + +<dl> + <dt>{{deprecated_inline}} {{domxref("performance.navigation")}} {{readonlyInline}}</dt> + <dd>ページがロードかリフレッシュか、リダイレクトの発生回数など、<code>timing</code> にリストされている時間に含まれる操作に関する有用なコンテキストを提供するレガシー {{domxref("PerformanceNavigation")}} オブジェクト。Worker では利用できません。</dd> + <dt>{{deprecated_inline}} {{domxref("performance.timing")}} {{readonlyInline}}</dt> + <dd>待ち時間関連のパフォーマンス情報を含むレガシー {{domxref("PerformanceTiming")}} オブジェクト。Worker には利用できません。</dd> + <dt>{{domxref("performance.memory", "performance.memory")}} {{Non-standard_inline}}</dt> + <dd>Chrome で追加された<em>非標準の</em>拡張子で、このプロパティは基本的なメモリ使用量情報を持つオブジェクトを提供します。<em>この非標準の API を<strong>使うべきではありません</strong></em>。</dd> + <dt>{{domxref("performance.timeOrigin")}} {{readonlyInline}} {{Non-standard_inline}}</dt> + <dd>パフォーマンス測定の開始時刻のハイレゾリューションタイムスタンプを返します。</dd> +</dl> + +<h2 id="メソッド">メソッド</h2> + +<p><em><em><code>Performance</code> インターフェイス</em>はメソッドを継承しません。</em></p> + +<dl> + <dt>{{domxref("performance.clearMarks()")}}</dt> + <dd>ブラウザのパフォーマンスエントリバッファから指定された<em>マーク</em>を削除します。</dd> + <dt>{{domxref("performance.clearMeasures()")}}</dt> + <dd>ブラウザのパフォーマンスエントリバッファから指定された<em>数値</em>を削除します。</dd> + <dt>{{domxref("performance.clearResourceTimings()")}}</dt> + <dd>ブラウザのパフォーマンスデータバッファから "<code>resource</code>" の {{domxref("PerformanceEntry.entryType","entryType")}} を持つすべての {{domxref("PerformanceEntry","performance entries")}} を削除します。</dd> + <dt>{{domxref("performance.getEntries()")}}</dt> + <dd>与えられた<em>フィルタ</em>に基づく {{domxref("PerformanceEntry")}} オブジェクトのリストを返します。</dd> + <dt>{{domxref("performance.getEntriesByName()")}}</dt> + <dd>指定された<em>名前</em>と<em>エントリタイプ</em>に基づいて {{domxref("PerformanceEntry")}} オブジェクトのリストを返します。</dd> + <dt>{{domxref("performance.getEntriesByType()")}}</dt> + <dd>与えられた<em>エントリタイプ</em>の {{domxref("PerformanceEntry")}} オブジェクトのリストを返します。</dd> + <dt>{{domxref("performance.mark()")}}</dt> + <dd>指定された名前でブラウザの<em>パフォーマンスエントリバッファ</em>に{{domxref("DOMHighResTimeStamp","タイムスタンプ")}}を作成します。</dd> + <dt>{{domxref("performance.measure()")}}</dt> + <dd>指定された2つのマーク (それぞれ<em>開始マーク</em>と<em>終了マーク</em>と呼ばれる) の間に、ブラウザのパフォーマンスエントリバッファ内に名前付き{{domxref("DOMHighResTimeStamp","タイムスタンプ")}}を作成します。</dd> + <dt>{{domxref("performance.now()")}}</dt> + <dd>参照時点から経過したミリ秒数を表す {{domxref("DOMHighResTimeStamp")}} を返します。</dd> + <dt>{{domxref("performance.setResourceTimingBufferSize()")}}</dt> + <dd>ブラウザのリソースタイミングバッファサイズを、指定された数の "<code>resource</code>" {{domxref("PerformanceEntry.entryType","タイプ")}} {{domxref("PerformanceEntry","パフォーマンスエントリ")}} オブジェクトに設定します。</dd> + <dt>{{domxref("performance.toJSON()")}}</dt> + <dd><code>Performance</code> オブジェクトを表す json オブジェクトを返す jsonizer です。</dd> +</dl> + +<h2 id="イベント">イベント</h2> + +<p><code>addEventListener()</code> を使用するか、このインターフェイスの <code>on<em>eventname</em></code> プロパティにイベントリスナを割り当てることで、イベントを監視します。</p> + +<dl> + <dt><code><a href="/ja/docs/Web/API/Performance/resourcetimingbufferfull_event">resourcetimingbufferfull</a></code></dt> + <dd>ブラウザの<a href="/ja/docs/Web/API/Performance/setResourceTimingBufferSize">リソースタイミングバッファ</a>がいっぱいになったときに発生します。<code><a href="/ja/docs/Web/API/Performance/onresourcetimingbufferfull">onresourcetimingbufferfull</a></code> プロパティからも利用できます。</dd> +</dl> + +<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('Highres Time Level 2', '#the-performance-interface', 'toJSON()')}}</td> + <td>{{Spec2('Highres Time Level 2')}}</td> + <td><code>toJson()</code> メソッドを定義します。</td> + </tr> + <tr> + <td>{{SpecName('Highres Time', '#the-performance-interface', 'Performance')}}</td> + <td>{{Spec2('Highres Time')}}</td> + <td><code>now()</code> メソッドを定義します。.</td> + </tr> + <tr> + <td>{{SpecName('Navigation Timing', '#sec-window.performance-attribute', 'Performance')}}</td> + <td>{{Spec2('Navigation Timing')}}</td> + <td><code>timing</code> と <code>navigation</code> プロパティを定義します。</td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline Level 2', '#extensions-to-the-performance-interface', 'Performance extensions')}}</td> + <td>{{Spec2('Performance Timeline Level 2')}}</td> + <td><code>getEntries()</code> インターフェイスを変更します。</td> + </tr> + <tr> + <td>{{SpecName('Performance Timeline', '#sec-window.performance-attribute', 'Performance extensions')}}</td> + <td>{{Spec2('Performance Timeline')}}</td> + <td><code>getEntries()</code>、<code>getEntriesByType()</code> および <code>getEntriesByName()</code> メソッドを定義します。</td> + </tr> + <tr> + <td>{{SpecName('Resource Timing', '#extensions-performance-interface', 'Performance extensions')}}</td> + <td>{{Spec2('Resource Timing')}}</td> + <td><code>clearResourceTimings()</code> と <code>setResourceTimingBufferSize()</code> メソッド、そして <code>onresourcetimingbufferfull</code> プロパティを定義します。</td> + </tr> + <tr> + <td>{{SpecName('User Timing Level 2', '#extensions-performance-interface', 'Performance extensions')}}</td> + <td>{{Spec2('User Timing Level 2')}}</td> + <td><code>mark()</code>、<code>clearMark()</code>、<code>measure()</code> および <code>clearMeasure()</code> インターフェイスを明確にします。</td> + </tr> + <tr> + <td>{{SpecName('User Timing', '#extensions-performance-interface', 'Performance extensions')}}</td> + <td>{{Spec2('User Timing')}}</td> + <td><code>mark()</code>, <code>clearMark()</code>, <code>measure()</code> および <code>clearMeasure()</code> インターフェイスを定義します。</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")}}</p> +</div> |