导航计时 第2级

PerformanceNavigationTiming 接口扩展了 PerformanceEntry 接口的以下属性：

• entryType getter 步骤返回 DOMString "navigation"。
• startTime getter 步骤返回一个时间值为 0 的 DOMHighResTimeStamp。
• duration getter 步骤返回一个 DOMHighResTimeStamp，其值等于 loadEventEnd 与 this 的 startTime 之间的差值。

PerformanceNavigationTiming 接口扩展了 PerformanceResourceTiming 接口的以下属性：

• redirectStart getter 步骤执行以下操作：
  1. 如果 this 的 [=PerformanceNavigationTiming/redirect count] 为 0，则返回 0。
  2. 否则返回 this 的 redirectStart。
• redirectEnd getter 步骤执行以下操作：
  1. 如果 this 的 [=PerformanceNavigationTiming/redirect count] 为 0，则返回 0。
  2. 否则返回 this 的 redirectEnd。
  注意

  尽管 redirectStart 和 redirectEnd 在 PerformanceResourceTiming 中公开，但它们在导航计时中具有不同的含义，对于具有跨域重定向的导航，它们返回零。

• workerStart getter 步骤执行以下操作：
  1. 令 workerTiming 为 this 的 服务工作线程计时。
  2. 如果 workerTiming 为 null，则返回 this 的原型的 workerStart。
  3. 返回 workerTiming 的 开始时间。
  注意

  尽管 workerStart 在 PerformanceResourceTiming 中公开，但它在导航计时中具有不同的含义，因为与子资源不同，导航可能会触发服务工作线程的激活或运行。 在导航计时的上下文中，workerStart 返回在工作线程被激活或启动之前测量的时间戳。有关精确定义，请参见 [service-workers]。

• fetchStart getter 步骤执行以下操作：
  1. 令 workerTiming 为 this 的 服务工作线程计时。
  2. 如果 workerTiming 为 null，则返回 this 的原型的 fetchStart。
  3. 返回 workerTiming 的 fetch 事件分派时间。
  注意

  当服务工作线程用作导航的一部分时，fetchStart 重载的含义与 PerformanceResourceTiming 中的含义不同。 它返回在为服务工作线程分派 FetchEvent 之前测量的时间戳。文档导航计时条目中 workerStart 和 fetchStart 之间的时间差可用于大致确定工作线程初始化或激活所需的时间。有关精确定义，请参见 [service-workers]。

WebIDL[Exposed=Window]
interface PerformanceNavigationTiming : PerformanceResourceTiming {
    readonly        attribute DOMHighResTimeStamp  unloadEventStart;
    readonly        attribute DOMHighResTimeStamp  unloadEventEnd;
    readonly        attribute DOMHighResTimeStamp  domInteractive;
    readonly        attribute DOMHighResTimeStamp  domContentLoadedEventStart;
    readonly        attribute DOMHighResTimeStamp  domContentLoadedEventEnd;
    readonly        attribute DOMHighResTimeStamp  domComplete;
    readonly        attribute DOMHighResTimeStamp  loadEventStart;
    readonly        attribute DOMHighResTimeStamp  loadEventEnd;
    readonly        attribute NavigationTimingType type;
    readonly        attribute unsigned short       redirectCount;
    readonly        attribute DOMHighResTimeStamp  criticalCHRestart;
    readonly        attribute NotRestoredReasons?  notRestoredReasons;
    [Default] object toJSON();
};

一个 PerformanceNavigationTiming 有一个关联的 文档加载计时信息 文档加载计时。

一个 PerformanceNavigationTiming 有一个关联的 文档卸载计时信息 先前文档卸载计时。

一个 PerformanceNavigationTiming 有一个关联的 数字 重定向计数。

一个 PerformanceNavigationTiming 有一个关联的 NavigationTimingType 导航类型。

一个 PerformanceNavigationTiming 有一个关联的 DOMHighResTimeStamp Critical-CH 重启时间。

一个 PerformanceNavigationTiming 有一个关联的 NotRestoredReasons 未恢复原因。

一个 PerformanceNavigationTiming 有一个关联的 null 或 服务工作线程计时信息 服务工作线程计时。

unloadEventStart getter 步骤是返回 this 的 先前文档卸载计时的 卸载事件开始时间。

unloadEventEnd getter 步骤是返回 this 的 先前文档卸载计时的 卸载事件结束时间。

domInteractive getter 步骤是返回 this 的 文档加载计时的 DOM 交互时间。

domContentLoadedEventStart getter 步骤是返回 this 的 文档加载计时的 DOM 内容加载事件开始时间。

domContentLoadedEventEnd getter 步骤是返回 this 的 文档加载计时的 DOM 内容加载事件结束时间。

domComplete getter 步骤是返回 this 的 文档加载计时的 DOM 完成时间。

loadEventStart getter 步骤是返回 this 的 文档加载计时的 加载事件开始时间。

loadEventEnd getter 步骤是返回 this 的 文档加载计时的 加载事件结束时间。

type getter 步骤是运行 this 的 导航类型。

redirectCount getter 步骤是返回 this 的 重定向计数。

criticalCHRestart getter 步骤是返回 this 的 Critical-CH 重启时间。

notRestoredReasons getter 步骤是返回 this 的 未恢复原因。

toJSON() 方法为 this 运行默认 toJSON 步骤。

WebIDLenum NavigationTimingType {
                    "navigate",
                    "reload",
                    "back_forward",
                    "prerender"
                };

WebIDL[Exposed=Window]
interface PerformanceTiming {
  readonly attribute unsigned long long navigationStart;
  readonly attribute unsigned long long unloadEventStart;
  readonly attribute unsigned long long unloadEventEnd;
  readonly attribute unsigned long long redirectStart;
  readonly attribute unsigned long long redirectEnd;
  readonly attribute unsigned long long fetchStart;
  readonly attribute unsigned long long domainLookupStart;
  readonly attribute unsigned long long domainLookupEnd;
  readonly attribute unsigned long long connectStart;
  readonly attribute unsigned long long connectEnd;
  readonly attribute unsigned long long secureConnectionStart;
  readonly attribute unsigned long long requestStart;
  readonly attribute unsigned long long responseStart;
  readonly attribute unsigned long long responseEnd;
  readonly attribute unsigned long long domLoading;
  readonly attribute unsigned long long domInteractive;
  readonly attribute unsigned long long domContentLoadedEventStart;
  readonly attribute unsigned long long domContentLoadedEventEnd;
  readonly attribute unsigned long long domComplete;
  readonly attribute unsigned long long loadEventStart;
  readonly attribute unsigned long long loadEventEnd;
  [Default] object toJSON();
};

navigationStart

该属性必须返回用户代理完成提示卸载 前一文档之后的时间。如果没有前一文档，该属性必须返回创建当前文档的时间。

注意

此属性未为 PerformanceNavigationTiming 定义。 相反，作者可以使用 timeOrigin 来获取等效的时间戳。

unloadEventStart

如果前一个文档和当前文档具有相同的来源，则此属性必须返回用户代理开始前一个文档的 卸载事件的时间。如果没有前一个文档，或者前一个文档与当前文档的 来源不同，则此属性必须返回0。

unloadEventEnd

如果前一个文档和当前文档具有相同的相同来源，此属性必须返回用户代理完成前一个文档的 卸载事件后的时间。如果没有前一个文档，或者前一个文档与当前文档的 来源不同，或者卸载尚未完成，则此属性必须返回0。

如果导航过程中有HTTP重定向，并且并非所有重定向都来自相同的 来源，那么 PerformanceTiming.unloadEventStart 和 PerformanceTiming.unloadEventEnd必须返回0。

redirectStart

如果导航过程中有HTTP重定向，并且所有重定向都来自相同的 来源，则此属性必须返回发起重定向的 fetch的起始时间。否则，此属性必须返回0。

redirectEnd

如果导航过程中有HTTP重定向，并且所有重定向都来自相同的 来源，此属性必须返回接收到最后一个重定向响应的最后一个字节后的时间。否则，此属性必须返回0。

fetchStart

如果新的资源是使用"GET" 请求方法来 获取的， 则fetchStart必须返回用户代理开始检查 HTTP缓存 之前的时间。否则，它必须返回用户代理开始 获取资源的时间。

domainLookupStart

此属性必须返回用户代理开始当前文档的域名查找之前的时间。如果使用了 持久连接 [RFC2616] 或者当前文档从 HTTP缓存 或本地资源中检索，则此属性必须返回与 PerformanceTiming.fetchStart 相同的值。

domainLookupEnd

此属性必须返回用户代理完成当前文档的域名查找后的时间。如果使用了 持久连接 [RFC2616] 或者当前文档从 HTTP缓存 或本地资源中检索，则此属性必须返回与 PerformanceTiming.fetchStart 相同的值。

注释

从 HTTP缓存 [RFC2616] 检查和检索内容是获取资源过程的一部分。它包括 PerformanceTiming.requestStart, PerformanceTiming.responseStart 和 PerformanceTiming.responseEnd 属性。

注释

如果用户代理已经在缓存中拥有域名信息，domainLookupStart和domainLookupEnd表示用户代理开始和结束从缓存中检索域数据的时间。

connectStart

此属性必须返回用户代理开始建立连接以检索文档之前的时间。如果使用了 持久连接 [RFC2616] 或者当前文档从 HTTP缓存 或本地资源中检索，则此属性必须返回 PerformanceTiming.domainLookupEnd 的值。

connectEnd

此属性必须返回用户代理完成与服务器建立连接以检索当前文档后的时间。如果使用了 持久连接 [RFC2616] 或者当前文档从 HTTP缓存 或本地资源中检索，则此属性必须返回 PerformanceTiming.domainLookupEnd 的值。

如果传输连接失败并且用户代理重新打开连接， PerformanceTiming.connectStart 和 PerformanceTiming.connectEnd 应该返回新连接的相应值。

PerformanceTiming.connectEnd 必须包括建立传输连接的时间间隔以及其他时间间隔，例如SSL握手和SOCKS身份验证。

secureConnectionStart

此属性是可选的。没有此属性的用户代理必须将其设置为undefined。当此属性可用时，如果当前页面的 协议 [URL] 是"HTTPS"，此属性必须返回用户代理开始握手过程以安全连接的时间。如果此属性可用但未使用HTTPS，则此属性必须返回0。

requestStart

此属性必须返回用户代理从服务器、HTTP 缓存或本地资源请求当前文档之前的时间。

如果传输连接在请求发送后失败，用户代理重新打开连接并重新发送请求， PerformanceTiming.requestStart 应该返回新请求的相应值。

注意

此接口不包括表示请求完成发送的属性，例如 requestEnd。

• 从用户代理发送请求的完成时间并不总是指示网络传输中的相应完成时间，这使得拥有此类属性的好处不明显。
• 一些用户代理由于 HTTP 层的封装而难以确定发送请求的实际完成时间。

responseStart

此属性必须返回用户代理从服务器、HTTP 缓存或本地资源接收响应的第一个字节后的时间。

responseEnd

此属性必须返回用户代理接收到当前文档的最后一个字节后的时间，或者在传输连接关闭之前的时间，以先发生者为准。此文档可以是从服务器、HTTP 缓存或本地资源中接收的。

domLoading

此属性必须返回用户代理将当前文档就绪状态设置为 "loading" 之前的时间。

警告

由于现有用户代理在创建 Document 对象时的差异，domLoading 返回的值是实现特定的，不应用于有意义的指标。

domInteractive

此属性必须返回用户代理将当前文档就绪状态设置为 "interactive" 之前的时间。

domContentLoadedEventStart

此属性必须返回用户代理在 DOMContentLoaded 事件 在 Document 上触发之前的时间。

domContentLoadedEventEnd

此属性必须返回文档的 DOMContentLoaded 事件 完成后的时间。

domComplete

此属性必须返回用户代理将 当前文档就绪状态 设置为 "complete" 之前的时间。

如果 当前文档就绪状态 多次变为相同状态， PerformanceTiming.domLoading、 PerformanceTiming.domInteractive、 PerformanceTiming.domContentLoadedEventStart、 PerformanceTiming.domContentLoadedEventEnd 和 PerformanceTiming.domComplete 必须返回相应的 文档就绪状态 变更的第一次出现时间。

loadEventStart

此属性必须返回当前文档的 load 事件触发之前的时间。当 load 事件尚未触发时，必须返回零。

loadEventEnd

此属性必须返回当前文档的 load 事件完成时的时间。当 load 事件尚未触发或未完成时，必须返回零。

toJSON()

为 this 运行默认 toJSON 步骤。

WebIDL[Exposed=Window]
interface PerformanceNavigation {
  const unsigned short TYPE_NAVIGATE = 0;
  const unsigned short TYPE_RELOAD = 1;
  const unsigned short TYPE_BACK_FORWARD = 2;
  const unsigned short TYPE_RESERVED = 255;
  readonly attribute unsigned short type;
  readonly attribute unsigned short redirectCount;
  [Default] object toJSON();
};

TYPE_NAVIGATE

导航类型设置为 默认历史处理行为 或 "replace"。

TYPE_RELOAD

导航类型设置为 重新加载。

TYPE_BACK_FORWARD

导航类型设置为 历史条目更新。

TYPE_RESERVED

上述值未定义的任何其他导航类型。

type

此属性必须返回当前浏览上下文中最后一次非重定向导航的类型。它必须具有以下 导航类型 之一。

注意

客户端重定向，如使用 Refresh 说明指令 的重定向，不被此规范视为 HTTP 重定向。在这种情况下， type 属性应返回适当的值，例如在重新加载当前页面时返回 TYPE_RELOAD，或在导航到新 URL 时返回 TYPE_NAVIGATE。

redirectCount

此属性必须返回当前浏览上下文中自上次非重定向导航以来的重定向次数。如果没有重定向，或存在与目标文档不同源的重定向，则此属性必须返回零。

toJSON()

为 this 运行默认 toJSON 步骤。

WebIDL[Exposed=Window]
partial interface Performance {
  [SameObject]
  readonly attribute PerformanceTiming timing;
  [SameObject]
  readonly attribute PerformanceNavigation navigation;
};

Performance 接口在 [PERFORMANCE-TIMELINE-2] 中定义。

timing

timing 属性表示自上次非重定向导航以来与浏览上下文相关的计时信息。此属性由 PerformanceTiming 接口定义。

navigation

navigation 属性由 PerformanceNavigation 接口定义。