---
title: PerformanceFrameTiming
slug: Web/API/PerformanceFrameTiming
tags:
  - API
  - PerformanceFrameTiming
  - Web パフォーマンス
  - インターフェイス
  - パフォーマンスタイムライン API
  - フレームタイミング API
  - リファレンス
translation_of: Web/API/PerformanceFrameTiming
---
<div>{{APIRef("Frame Timing API")}}{{SeeCompatTable}}</div>

<div><span class="seoSummary"><strong><code>PerformanceFrameTiming</code></strong> は、ブラウザのイベントループに関するフレームタイミングデータを提供する抽象インターフェイスです。</span> フレームは、DOM イベントの処理、サイズ変更、スクロール、レンダリング、CSS アニメーションなど、<a href="https://html.spec.whatwg.org/multipage/webappapis.html#processing-model-8">1つのイベントループ</a>でブラウザが実行する作業量を表します。60 Hz のリフレッシュレートに対して 60 fps (フレーム/秒) のフレームレートは、応答性の良いユーザーエクスペリエンスの目標です。これはブラウザが約 16.7 ms でフレームを処理するはずであることを意味します。</div>

<div> </div>

<p>アプリケーションは、"<code>frame</code>" {{domxref("PerformanceEntry","パフォーマンスエントリタイプ")}}に {{domxref("PerformanceObserver")}} を登録することができます。オブザーバーは各フレームイベントの期間に関するデータを取得できます。この情報は、優れたユーザーエクスペリエンスを提供するのに時間がかかりすぎる領域を特定するのに役立ちます。</p>

<p>{{InheritanceDiagram}}</p>

<h2 id="プロパティ">プロパティ</h2>

<p>このインターフェイスにはプロパティはありませんが、次のようにプロパティを修飾および制約することで、次の {{domxref("PerformanceEntry")}} プロパティ ("<code>frame</code>" {{domxref ("PerformanceEntry.entryType","performance entry types")}} 用) を拡張します。</p>

<dl>
 <dt>{{domxref("PerformanceEntry.entryType")}}</dt>
 <dd>"<code>frame</code>" を返します。</dd>
 <dt>{{domxref("PerformanceEntry.name")}}</dt>
 <dd><a href="https://dom.spec.whatwg.org/#concept-document-url">ドキュメントのアドレス</a>を返します。</dd>
 <dt>{{domxref("PerformanceEntry.startTime")}}</dt>
 <dd>フレームが開始されたときに {{domxref("DOMHighResTimeStamp","タイムスタンプ")}} を返します。</dd>
 <dt>{{domxref("PerformanceEntry.duration")}}</dt>
 <dd>連続する2つのフレームの <code>startTime</code> 間の差を示す {{domxref("DOMHighResTimeStamp","タイムスタンプ")}} を返します。</dd>
</dl>

<h2 id="メソッド">メソッド</h2>

<p>このインターフェイスにはメソッドがありません。</p>

<h2 id="例">例</h2>

<p><a href="/ja/docs/Web/API/Frame_Timing_API/Using_the_Frame_Timing_API">フレームタイミング API の使用</a>の例を参照してください。</p>

<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('Frame Timing', '#performancereframetiming', 'PerformanceFrameTiming')}}</td>
   <td>{{Spec2('Frame Timing')}}</td>
   <td>初期定義</td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザの互換性">ブラウザの互換性</h2>

<div>
<p>{{Compat("api.PerformanceFrameTiming")}}</p>
</div>

<h2 id="あわせて参照">あわせて参照</h2>

<ul>
 <li>{{domxref("PerformanceObserver")}}</li>
 <li><a href="/ja/docs/Tools/Performance/Frame_rate">フレームレート (Firefox パフォーマンスツール)</a></li>
 <li><a href="/ja/docs/Web/API/Frame_Timing_API">フレームタイミング (概要)</a></li>
 <li>
  <p><a href="/ja/docs/Web/API/Frame_Timing_API/Using_the_Frame_Timing_API">フレームタイミング API の使用</a></p>
 </li>
</ul>