パフォーマンスタイムライン API は、Performance
インターフェイスへの拡張を定義して、アプリケーション内のクライアントサイドの待ち時間の測定をサポートします。 拡張機能は、特定のフィルタ基準に基づいてperformance entry metrics を取得するためのインターフェイスを提供します。この規格には、特定のパフォーマンスイベントがブラウザのパフォーマンスタイムラインに追加されたときに通知される performance observer コールバックをアプリケーションで定義できるインターフェイスも含まれます。
このドキュメントは規格のインターフェイスの概要を提供します。インターフェイスの詳細については、リファレンスページおよびパフォーマンスタイムラインの使用を参照してください。
Performance 拡張
パフォーマンスタイムライン API は、Performance
インターフェイスを、指定されたフィルター基準に応じて一連の パフォーマンスレコード (メトリック)
を取得するためのさまざまなメカニズムを提供する3つのメソッドで拡張します。メソッドは以下のとおりです。
getEntries()
- Returns all recorded
performance entries
or, optionally, the entries based on the specifiedname
,performance type
and/or theinitiatorType
(such as an HTML element). getEntriesByName()
- Returns the recorded
performance entries
based on the specifiedname
and optionally theperformance type
. getEntriesByType()
- Returns the recorded
performance entries
based on the specifiedperformance type
.
PerformanceEntry インターフェイス
The PerformanceEntry
interface encapsulates a single performance entry — that is, a single data point or metric in the performance timeline. This interface has the following four properties, and these properties are extended (with additional constraints) by other interfaces (such as PerformanceMark
):
name
- The name of the performance entry when the metric was created.
entryType
- The type of performance metric (for example, "
mark
"). startTime
- A
high resolution timestamp
representing the starting time for the performance entry. duration
- A high resolution timestamp representing the time value of the duration of the performance event. (Some performance entry types have no concept of duration and this value is set to
'0'
for such types.)
This interface includes a toJSON()
method that returns the serialization of the PerformanceEntry
object. The serialization is specific to the performance entry's type
.
Performance オブザーバー
Experimental
これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
The performance observer interfaces allow an application to register an observer for specific performance event types, and when one of those event types is recorded, the application is notified of the event via the observer's callback function that was specified when the observer was created.
When the observer (callback) is invoked, the callback's parameters include a performance observer entry list
that contains only observed performance entries
. That is, the list contains entries only for the event types that were specified when the observer's observe()
method was invoked. The performance observer entry list
interface has the same three getEntries*()
methods as the Performance
interface. However, note there is one key difference with these methods; the performance observer entry list
versions are used to retrieve observed performance entries within the observer callback.
Besides the PerformanceObserver's
interface's observe()
method (which is used to register the entry types
to observe), the PerformanceObserver
interface also has a disconnect()
method that stops an observer from receiving further events.
Performance observers were added to the Level 2
version of the standard and were not widely implemented.
実装状況
A summary of the interfaces' implementation status is provided below, including a link to more detailed information.
- Performance interface extensions: As shown in the
Performance
interface's Browser Compatibility table, most of these interfaces are broadly implemented by desktop browsers and have less support on mobile devices. - PerformanceEntry: As shown in the
PerformanceEntry
interface's Browser Compatibility table, most of these interfaces are broadly implemented by desktop browsers and have less support on mobile devices. - Performance Observers : As shown in the
PerformanceObserver
interface's Browser Compatibility table, this interface has no shipping implementations.
To test your browser's support for these interfaces, run the perf-api-support
application.