---
title: PerformanceObserver
slug: Web/API/PerformanceObserver
tags:
  - API
  - PerformanceObserver
  - Web パフォーマンス
  - observers
  - インターフェイス
  - パフォーマンスオブザーバー API
  - リファレンス
translation_of: Web/API/PerformanceObserver
---
<div>{{APIRef("Performance Timeline API")}}</div>

<p><span class="seoSummary"><strong><code>PerformanceObserver</code></strong> インターフェイスは、パフォーマンス測定イベントを監視し、ブラウザのパフォーマンスタイムラインに記録されているので、新しい{{domxref("PerformanceEntry","performance entries", '', 'true')}} の通知を受けるために使用されます。</span></p>

<p>{{AvailableInWorkers}}</p>

<h2 id="コンストラクター">コンストラクター</h2>

<dl>
 <dt>{{domxref("PerformanceObserver.PerformanceObserver","PerformanceObserver()")}}</dt>
 <dd>新しい <code>PerformanceObserver</code> オブジェクトを作成して返します。</dd>
</dl>

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

<dl>
 <dt>{{domxref("PerformanceObserver.observe","PerformanceObserver.observe()")}}</dt>
 <dd>監視する{{domxref("PerformanceEntry.entryType","エントリタイプ")}}のセットを指定します。指定された <code>entryTypes</code> の1つに対して {{domxref("PerformanceEntry","パフォーマンスエントリ")}} が記録されている場合、パフォーマンスオブザーバのコールバック関数が呼び出されます。</dd>
 <dt>{{domxref("PerformanceObserver.disconnect","PerformanceObserver.disconnect()")}}</dt>
 <dd>パフォーマンスオブザーバのコールバックが{{domxref("PerformanceEntry","パフォーマンスエントリ")}}を受け取らないようにします。</dd>
 <dt>{{domxref("PerformanceObserver.takeRecords","PerformanceObserver.takeRecords()")}}</dt>
 <dd>パフォーマンスオブザーバに格納されている{{domxref("PerformanceEntry","パフォーマンスエントリ")}} の現在のリストを空にして返します。</dd>
</dl>

<dl>
</dl>

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

<pre class="brush: js">function perf_observer(list, observer) {
   // Process the "measure" event
}
var observer2 = new PerformanceObserver(perf_observer);
observer2.observe({entryTypes: ["measure"]});</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('Performance Timeline Level 2', '#dom-performanceobserver', 'PerformanceObserver')}}</td>
   <td>{{Spec2('Performance Timeline Level 2')}}</td>
   <td><code>PerformanceObserver</code> インターフェイスの初期定義</td>
  </tr>
 </tbody>
</table>

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

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

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

<ul>
 <li>{{domxref('MutationObserver')}}</li>
 <li>{{domxref('ResizeObserver')}}</li>
 <li>{{domxref('IntersectionObserver')}}</li>
</ul>