Performance
インターフェイスは、現在のページのパフォーマンス関連情報へのアクセスを提供します。これはHigh Resolution Time API の一部ですが、Performance Timeline API、Navigation Timing API、User Timing API、および Resource Timing API によって拡張されています。
このタイプのオブジェクトは読み取り専用属性 window.performance
を呼び出すことで取得できます。
メモ: このインターフェイスとそのメンバーは、以下に示されている場合を除き、Web Workers で利用可能です。 パフォーマンスマーカーと測定値はコンテキストごとにあることにも注意してください。メインスレッド (または他のワーカー) にマークを作成した場合、それを Worker スレッドには表示できません (その逆も同様)。
プロパティ
Performance
インターフェイスはプロパティを継承しません。
-
performance.navigation
読取専用 - ページがロードかリフレッシュか、リダイレクトの発生回数など、
timing
にリストされている時間に含まれる操作に関する有用なコンテキストを提供するレガシーPerformanceNavigation
オブジェクト。Worker では利用できません。 -
performance.timing
読取専用 - 待ち時間関連のパフォーマンス情報を含むレガシー
PerformanceTiming
オブジェクト。Worker には利用できません。 performance.memory
- Chrome で追加された非標準の拡張子で、このプロパティは基本的なメモリ使用量情報を持つオブジェクトを提供します。この非標準の API を使うべきではありません。
performance.timeOrigin
読取専用- パフォーマンス測定の開始時刻のハイレゾリューションタイムスタンプを返します。
メソッド
Performance
インターフェイスはメソッドを継承しません。
performance.clearMarks()
- ブラウザのパフォーマンスエントリバッファから指定されたマークを削除します。
performance.clearMeasures()
- ブラウザのパフォーマンスエントリバッファから指定された数値を削除します。
performance.clearResourceTimings()
- ブラウザのパフォーマンスデータバッファから "
resource
" のentryType
を持つすべてのperformance entries
を削除します。 performance.getEntries()
- 与えられたフィルタに基づく
PerformanceEntry
オブジェクトのリストを返します。 performance.getEntriesByName()
- 指定された名前とエントリタイプに基づいて
PerformanceEntry
オブジェクトのリストを返します。 performance.getEntriesByType()
- 与えられたエントリタイプの
PerformanceEntry
オブジェクトのリストを返します。 performance.mark()
- 指定された名前でブラウザのパフォーマンスエントリバッファに
タイムスタンプ
を作成します。 performance.measure()
- 指定された2つのマーク (それぞれ開始マークと終了マークと呼ばれる) の間に、ブラウザのパフォーマンスエントリバッファ内に名前付き
タイムスタンプ
を作成します。 performance.now()
- 参照時点から経過したミリ秒数を表す
DOMHighResTimeStamp
を返します。 performance.setResourceTimingBufferSize()
- ブラウザのリソースタイミングバッファサイズを、指定された数の "
resource
"タイプ
パフォーマンスエントリ
オブジェクトに設定します。 performance.toJSON()
Performance
オブジェクトを表す json オブジェクトを返す jsonizer です。
イベント
addEventListener()
を使用するか、このインターフェイスの oneventname
プロパティにイベントリスナを割り当てることで、イベントを監視します。
resourcetimingbufferfull
- ブラウザのリソースタイミングバッファがいっぱいになったときに発生します。
onresourcetimingbufferfull
プロパティからも利用できます。
仕様
仕様 | ステータス | コメント |
---|---|---|
High Resolution Time Level 2 toJSON() の定義 |
勧告 | toJson() メソッドを定義します。 |
High Resolution Time Performance の定義 |
勧告 | now() メソッドを定義します。. |
Navigation Timing Performance の定義 |
勧告 | timing と navigation プロパティを定義します。 |
Performance Timeline Level 2 Performance extensions の定義 |
勧告候補 | getEntries() インターフェイスを変更します。 |
Performance Timeline Performance extensions の定義 |
勧告 | getEntries() 、getEntriesByType() および getEntriesByName() メソッドを定義します。 |
Resource Timing Level 1 Performance extensions の定義 |
勧告候補 | clearResourceTimings() と setResourceTimingBufferSize() メソッド、そして onresourcetimingbufferfull プロパティを定義します。 |
User Timing Level 2 Performance extensions の定義 |
草案 | mark() 、clearMark() 、measure() および clearMeasure() インターフェイスを明確にします。 |
User Timing Performance extensions の定義 |
勧告 | mark() , clearMark() , measure() および clearMeasure() インターフェイスを定義します。 |
ブラウザの互換性
BCD tables only load in the browser
このページの互換性テーブルは構造化データから生成されます。データに貢献したい場合は https://github.com/mdn/browser-compat-data をチェックして、プルリクエストを送ってください。