path: root/files/zh-cn/web/api/performancetiming/index.html

---
title: PerformanceTiming
slug: Web/API/PerformanceTiming
tags:
  - API
  - Navi
translation_of: Web/API/PerformanceTiming
---
<p>{{APIRef("Navigation Timing")}}</p>

<p><strong><code>PerformanceTiming</code></strong> 接口是为保持向后兼容性而保留的传统接口，并且提供了在加载和使用当前页面期间发生的各种事件的性能计时信息。</p>

<p>可以通过只读属性{{domxref("Performance.timing", "window.performance.timing")}} 获得实现该接口的一个对象。</p>

<h2 id="属性">属性</h2>

<p><em><code>PerformanceTiming</code> 接口不包含任何继承属性。</em></p>

<dl>
 <dt>{{domxref("PerformanceTiming.navigationStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，表征了从同一个浏览器上下文的上一个文档卸载(unload)结束时的UNIX时间戳。如果没有上一个文档，这个值会和PerformanceTiming.fetchStart相同。</dd>
 <dt>{{domxref("PerformanceTiming.unloadEventStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，表征了{{event("unload")}}事件抛出时的UNIX时间戳。如果没有上一个文档，or if the previous document, or one of the needed redirects, is not of the same origin, 这个值会返回0.</dd>
 <dt>{{domxref("PerformanceTiming.unloadEventEnd")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，表征了{{event("unload")}}事件处理完成时的UNIX时间戳。如果没有上一个文档，or if the previous document, or one of the needed redirects, is not of the same origin, 这个值会返回0.</dd>
 <dt>{{domxref("PerformanceTiming.redirectStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，表征了第一个HTTP重定向开始时的UNIX时间戳。如果没有重定向，或者重定向中的一个不同源，这个值会返回0.</dd>
 <dt>{{domxref("PerformanceTiming.redirectEnd")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，表征了最后一个HTTP重定向完成时（也就是说是HTTP响应的最后一个比特直接被收到的时间）的UNIX时间戳。如果没有重定向，或者重定向中的一个不同源，这个值会返回0.</dd>
 <dt>{{domxref("PerformanceTiming.fetchStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，表征了浏览器准备好使用HTTP请求来获取(fetch)文档的UNIX时间戳。这个时间点会在检查任何应用缓存之前。</dd>
 <dt>{{domxref("PerformanceTiming.domainLookupStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，表征了域名查询开始的UNIX时间戳。如果使用了持续连接(persistent connection)，或者这个信息存储到了缓存或者本地资源上，这个值将和 <code>PerformanceTiming.fetchStart一致。</code></dd>
 <dt>{{domxref("PerformanceTiming.domainLookupEnd")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，表征了域名查询结束的UNIX时间戳。如果使用了持续连接(persistent connection)，或者这个信息存储到了缓存或者本地资源上，这个值将和 <code>PerformanceTiming.fetchStart一致。</code></dd>
 <dt>{{domxref("PerformanceTiming.connectStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回HTTP请求开始向服务器发送时的Unix毫秒时间戳。如果使用持久连接（persistent connection），则返回值等同于fetchStart属性的值。</dd>
 <dt>{{domxref("PerformanceTiming.connectEnd")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回浏览器与服务器之间的连接建立时的Unix毫秒时间戳。如果建立的是持久连接，则返回值等同于fetchStart属性的值。连接建立指的是所有握手和认证过程全部结束。</dd>
 <dt>{{domxref("PerformanceTiming.secureConnectionStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回浏览器与服务器开始安全链接的握手时的Unix毫秒时间戳。如果当前网页不要求安全连接，则返回0。</dd>
 <dt>{{domxref("PerformanceTiming.requestStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回浏览器向服务器发出HTTP请求时（或开始读取本地缓存时）的Unix毫秒时间戳。</dd>
 <dt>{{domxref("PerformanceTiming.responseStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回浏览器从服务器收到（或从本地缓存读取）第一个字节时的Unix毫秒时间戳。如果传输层在开始请求之后失败并且连接被重开，该属性将会被数制成新的请求的相对应的发起时间。</dd>
 <dt>{{domxref("PerformanceTiming.responseEnd")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回浏览器从服务器收到（或从本地缓存读取，或从本地资源读取）最后一个字节时（如果在此之前HTTP连接已经关闭，则返回关闭时）的Unix毫秒时间戳。</dd>
 <dt>{{domxref("PerformanceTiming.domLoading")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回当前网页DOM结构开始解析时（即{{domxref("Document.readyState")}}属性变为“loading”、相应的 {{event("readystatechange")}}事件触发时）的Unix毫秒时间戳。</dd>
 <dt>{{domxref("PerformanceTiming.domInteractive")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回当前网页DOM结构结束解析、开始加载内嵌资源时（即{{domxref("Document.readyState")}}属性变为“interactive”、相应的{{event("readystatechange")}}事件触发时）的Unix毫秒时间戳。</dd>
 <dt>{{domxref("PerformanceTiming.domContentLoadedEventStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回当解析器发送{{event("DOMContentLoaded")}} 事件，即所有需要被执行的脚本已经被解析时的Unix毫秒时间戳。</dd>
 <dt>{{domxref("PerformanceTiming.domContentLoadedEventEnd")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回当所有需要立即执行的脚本已经被执行（不论执行顺序）时的Unix毫秒时间戳。</dd>
 <dt>{{domxref("PerformanceTiming.domComplete")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回当前文档解析完成，即{{domxref("Document.readyState")}} 变为 <code>'complete'且相对应的</code>{{event("readystatechange")}} 被触发时的Unix毫秒时间戳。</dd>
 <dt>{{domxref("PerformanceTiming.loadEventStart")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回该文档下，{{event("load")}}事件被发送时的Unix毫秒时间戳。如果这个事件还未被发送，它的值将会是0。</dd>
 <dt>{{domxref("PerformanceTiming.loadEventEnd")}} {{readonlyInline}}</dt>
 <dd>是一个无符号long long 型的毫秒数，返回当{{event("load")}}事件结束，即加载事件完成时的Unix毫秒时间戳。如果这个事件还未被发送，或者尚未完成，它的值将会是0.</dd>
</dl>

<h2 id="方法">方法</h2>

<p><em><em><code>Performance</code> </em></em>接口不包含任何方法。</p>

<dl>
 <dt>{{domxref("PerformanceTiming.toJSON()")}} {{non-Standard_Inline}}</dt>
 <dd>是一个JSON格式化工具，返回一个 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON" title="/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON">JSON 对象</a>，代表具体的 <code>PerformanceTiming</code> 对象。</dd>
</dl>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范名称</th>
   <th scope="col">规范状态</th>
   <th scope="col">说明</th>
  </tr>
  <tr>
   <td>{{SpecName('Navigation Timing', '#sec-navigation-timing-interface', 'PerformanceTiming')}}</td>
   <td>{{Spec2('Navigation Timing')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<div>
<div>


<p>{{Compat("api.PerformanceTiming")}}</p>
</div>
</div>

<h2 id="相关链接">相关链接</h2>

<ul>
 <li>{{domxref("Performance.timing")}} 属性会返回这样一个对象.</li>
</ul>