サーバータイミング

非規定と記載されているセクションだけでなく、この仕様書内のすべての作成ガイドライン、図、例、および注記は非規定です。それ以外の内容はすべて規定です。

この文書におけるキーワード MAY、MUST、SHOULD NOT は、 BCP 14 [RFC2119] [RFC8174] に記載されている通り、全て大文字で現れる場合のみ、その意味で解釈されます。

Server-Timing ヘッダーフィールドは、与えられたリクエスト-レスポンスサイクルに対して、1つ以上の指標と説明を通知するために使用されます。RFC5234 に基づくABNF（拡張Backus-Naur形式）の Server-Timing ヘッダーフィールド の構文は以下の通りです：

  Server-Timing             = #server-timing-metric
  server-timing-metric      = metric-name *( OWS ";" OWS server-timing-param )
  metric-name               = token
  server-timing-param       = server-timing-param-name OWS "=" OWS server-timing-param-value
  server-timing-param-name  = token
  server-timing-param-value = token / quoted-string

RFC7230 を参照し、#、*、OWS、token、quoted-stringの定義を確認してください。

レスポンスには同じ metric-name を持つ server-timing-metric エントリが複数存在する場合があり、ユーザーエージェントはこれらすべてのエントリを処理し、公開しなければなりません（MUST）。

ユーザーエージェントは、提供された指標をどの順序でも表示して構いません（MAY）。つまり、HTTPヘッダーフィールド内の指標の順序は重要ではありません。

このヘッダーフィールドは将来のパラメータ追加に対応できる拡張可能な構文で定義されています。レスポンスの Server-Timing ヘッダーフィールド内の特定の server-timing-param-name を認識しないユーザーエージェントは、そのトークンを無視し、エラーを通知せずに処理を継続しなければなりません（MUST）。

あいまいさを避けるため、1つのserver-timing-metric内でserver-timing-param-nameは複数回現れるべきではありません（SHOULD NOT）。もし同じserver-timing-param-nameが複数回指定された場合、最初のインスタンスのみを考慮し、たとえserver-timing-paramが不完全または無効であっても、以降のすべての出現はエラー通知などをせずに無視しなければなりません（MUST）。これはserver-timing-metric内のパラメータ順が重要になる唯一のケースです。

ユーザーエージェントは、server-timing-param-valueの後、次のserver-timing-paramや現在のserver-timing-metricの終了までの間に発見された余分な文字を無視しなければなりません（MUST）。

ユーザーエージェントは、metric-nameの後、最初のserver-timing-paramや次のserver-timing-metricまでの間に発見された余分な文字を無視しなければなりません（MUST）。

この仕様では、server-timing-param-namesとして "dur"（duration）および "desc"（description）を定義します。いずれも任意です。

Server-Timingヘッダーフィールドをパースするには、文字列fieldを与えて、以下の手順に従います：

1. positionを位置変数として、最初はfieldの先頭を指す。

2. nameを、コードポイントの並びを収集することで、fieldからU+003B(;)に等しくないものを、positionを基準に収集した結果とする。

3. 先頭と末尾のASCII空白を除去するをnameに適用する。

4. nameが空文字列の場合、nullを返す。

5. metricを新しいPerformanceServerTimingとして生成し、そのmetric nameにnameを設定する。

6. paramsを空の順序付きマップとする。

7. positionがfieldの末尾でない間、以下を繰り返す：

   1. positionを1進める。

   2. paramNameを、コードポイントの並びを収集することでfieldからU+003D(=)に等しくないものを、positionを基準に収集した結果とする。

   3. 先頭と末尾のASCII空白を除去するをparamNameに適用する。

   4. paramNameが空文字列であるか、params[paramName]が存在する場合、次へ。

   5. positionを1進める。

   6. paramValueを空文字列とする。

   7. ASCII空白をスキップするをfieldとpositionで適用する。

   8. positionのfieldのコードポイントがU+0022（"）であれば：

      1. paramValueに、HTTP引用文字列を収集するの結果（extract-value flagをセットした状態）をfieldとpositionで適用し、設定する。

      2. コードポイントの並びを収集するで、fieldからU+003B(;)に等しくないものをpositionを基準に収集する。結果は使用しない。

   9. それ以外の場合：

      1. rawParamValueを、コードポイントの並びを収集することでfieldからU+003B(;)に等しくないものをpositionを基準に収集した結果とする。

      2. paramValueを、rawParamValueの先頭と末尾のASCII空白を除去した結果とする。

8. 設定するで、metricのparamsにparamsを設定する。

9. metricを返す。

WebIDL[Exposed=(Window,Worker)]
interface PerformanceServerTiming {
  readonly attribute DOMString name;
  readonly attribute DOMHighResTimeStamp duration;
  readonly attribute DOMString description;
  [Default] object toJSON();
};

toJSON が呼び出された場合、[WEBIDL]の default toJSON steps を実行する。

この仕様で部分的に拡張される PerformanceResourceTiming インターフェースは [RESOURCE-TIMING] で定義されています。

WebIDL[Exposed=(Window,Worker)]
partial interface PerformanceResourceTiming {
  readonly attribute FrozenArray<PerformanceServerTiming> serverTiming;
};

永続メッセージヘッダーフィールド登録簿は、以下の登録内容で更新されるべきです（[RFC3864]参照）：