服务器计时

本规范中，除标记为非规范性的部分外，所有创作指南、图表、示例和注释均为非规范性内容。规范中的其他内容均为规范性内容。

本文档中的关键词 MAY（可以）、MUST（必须）和 SHOULD NOT（不应）应按照 BCP 14 [RFC2119] [RFC8174] 的定义进行解释，仅当这些词全部大写时才具有规范性含义，如本处所示。

Server-Timing 头字段用于在给定的请求-响应周期中传递一个或多个指标和描述。RFC5234 中给出的 ABNF（扩展巴科斯-诺尔范式）语法如下：

  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

有关 #、*、OWS、token 和 quoted-string 的定义，请参见 RFC7230。

一个响应 可以包含多个具有相同 metric-name 的 server-timing-metric 条目，且用户代理必须处理并公开所有这些条目。

用户代理可以以任意顺序呈现提供的指标——即 HTTP 头字段中指标的顺序无关紧要。

该头字段具有可扩展语法，以支持将来添加参数。对于响应的 Server-Timing 头字段中未识别的 server-timing-param-name，用户代理必须忽略这些标记并继续处理，而不是报告错误。

为避免歧义，单个server-timing-param-name不应在同一个server-timing-metric中出现多次。如果指定了多次，仅考虑第一次出现，即使该server-timing-param不完整或无效。所有后续出现必须被忽略，不得报告错误或以其他方式更改server-timing-metric的处理。这是参数顺序唯一有意义的情形。

用户代理必须忽略server-timing-param-value后、下一个server-timing-param和当前server-timing-metric结尾之前出现的多余字符。

用户代理必须忽略metric-name后、首个server-timing-param和下一个server-timing-metric之前出现的多余字符。

本规范为 server-timing-param-names "dur"（用于duration）和 "desc"（用于description）建立 server-timing-params，二者均为可选。

要解析 Server-Timing 头字段，给定字符串 field：

1. 令 position 为 位置变量，初始指向 field 的起始处。

2. 令 name 为从 field 收集、且不等于 U+003B (;) 的一串码点的结果，基于 position。

3. 去除 name 首尾的 ASCII 空白字符。

4. 如果 name 为空字符串，则返回 null。

5. 令 metric 为新的 PerformanceServerTiming，其指标名称为 name。

6. 令 params 为一个空的有序映射。

7. 当 position 未到达 field 末尾时：

   1. position 前进 1。

   2. 令 paramName 为从 field 收集、且不等于 U+003D (=) 的一串码点的结果，基于 position。

   3. 去除 paramName 首尾的 ASCII 空白字符。

   4. 如果 paramName 为空字符串，或 params[paramName] 已存在，则继续。

   5. position 前进 1。

   6. 令 paramValue 为空字符串。

   7. 在 field 中跳过 position 处的 ASCII 空白字符。

   8. 如果 field 的 position 处码点为 U+0022 (")，则：

      1. 将 paramValue 设为收集 HTTP 引号字符串的结果，参数为 field 和 position，extract-value 标志已设置。

      2. 从 field 收集、且不等于 U+003B (;) 的一串码点，基于 position。结果不使用。

   9. 否则：

      1. 令 rawParamValue 为从 field 收集、且不等于 U+003B (;) 的一串码点的结果，基于 position。

      2. 将 paramValue 设为 rawParamValue 去除首尾 ASCII 空白后的结果。

8. 将 metric 的参数设为 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] 的默认 toJSON 步骤。

PerformanceResourceTiming 接口（本规范部分扩展）定义于 [RESOURCE-TIMING]。

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

永久消息头字段注册表应根据以下信息进行更新（[RFC3864]）：