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

---
title: Navigation Timing API
slug: Web/API/Navigation_timing_API
tags:
  - Navigation Timing API
translation_of: Web/API/Navigation_timing_API
---
<p>{{DefaultAPISidebar("Navigation Timing")}}</p>

<p><strong>Navigation Timing API</strong> 提供了可用于衡量一个网站性能的数据。与用于相同目的的其他基于JavaScript的机制不同，该API可以提供可以更有用和更准确的端到端延迟数据。</p>

<p> </p>

<h2 id="Concepts_and_usage">Concepts and usage</h2>

<p>你可以使用Navigation Timing API在客户端收集性能数据，并用{{domxref("XMLHttpRequest")}} 或其它技术传送到服务端。同时，该API使你可以衡量之前难以获取的数据，如卸载前一个页面的时间，在域名解析上的时间，在执行{{event("load")}}事件处理器上花费的总时间等。</p>

<p> </p>

<h2 id="Interfaces">Interfaces</h2>

<p>{{domxref("Performance")}}</p>

<p>返回一个Performance对象。该对象由High Resolution Time API定义，Navigation Timing API 在此基础上增加了两个属性：{{domxref("Performance.timing", "timing")}} 和 {{domxref("Performance.navigation", "navigation")}}</p>

<p>{{domxref("PerformanceNavigationTiming")}}</p>

<p>提供了方法和属性来存取关于游览器文档navigation事件的相关数据。如文档实际加载/卸载的时间。</p>

<p>{{deprecated_inline}} {{domxref("PerformanceTiming")}}</p>

<p>曾被用来获取{{domxref("Performance.timing", "timing")}}的值，用来衡量页面性能。</p>

<p>{{deprecated_inline}}  {{domxref("PerformanceNavigation")}}</p>

<p>曾被用来获取{{domxref("Performance.navigation", "navigation")}}的值，用来描述加载相关的操作。</p>

<p> </p>

<p> </p>

<p>以下示例显示了如何测量感知加载时间：</p>

<pre>function onLoad() {
  var now = new Date().getTime();
  var page_load_time = now - performance.timing.navigationStart;
  console.log("User-perceived page loading time: " + page_load_time);
}
</pre>

<p>还有很多以毫秒为单位呈现的测量事件，你可以通过  {{domxref("PerformanceTiming")}} 接口得到它们。按照事件发生的先后顺序，这些事件的列表如下：</p>

<ul>
 <li>navigationStart</li>
 <li>unloadEventStart</li>
 <li>unloadEventEnd</li>
 <li>redirectStart</li>
 <li>redirectEnd</li>
 <li>fetchStart</li>
 <li>domainLookupStart</li>
 <li>domainLookupEnd</li>
 <li>connectStart</li>
 <li>connectEnd</li>
 <li>secureConnectionStart</li>
 <li>requestStart</li>
 <li>responseStart</li>
 <li>responseEnd</li>
 <li>domLoading</li>
 <li>domInteractive</li>
 <li>domContentLoadedEventStart</li>
 <li>domContentLoadedEventEnd</li>
 <li>domComplete</li>
 <li>loadEventStart</li>
 <li>loadEventEnd</li>
</ul>

<p><code>window.performance.navigation 对象存储了两个属性，它们表示触发页面加载的原因。这些原因可能是页面重定向、前进后退按钮或者普通的 </code>URL<code> 加载。</code></p>

<p>window.performance.navigation.type：</p>

<table class="standard-table" style="font-size: 14px;">
 <thead>
  <tr>
   <th scope="col">Constant</th>
   <th scope="col">Value</th>
   <th scope="col">Description</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><a name="const_next"><code>TYPE_NAVIGATE</code></a></td>
   <td>0</td>
   <td>
    <p>导航开始于点击链接、或者在用户代理中输入 URL、或者表单提交、或者通过除下表中 TYPE_RELOAD 和 TYPE_BACK_FORWARD 的脚本初始化操作。</p>
   </td>
  </tr>
  <tr>
   <td><a name="const_next_no_duplicate"><code>TYPE_RELOAD</code></a></td>
   <td>1</td>
   <td>
    <p>通过刷新操作或者 location.reload() 方法导航。</p>
   </td>
  </tr>
  <tr>
   <td><a name="const_prev"><code>TYPE_BACK_FORWARD</code></a></td>
   <td>2</td>
   <td>
    <p>通过历史遍历操作导航。</p>
   </td>
  </tr>
  <tr>
   <td><a name="const_prev_no_duplicate"><code>TYPE_UNDEFINED</code></a></td>
   <td>255</td>
   <td>
    <p>其他非以上类型的导航。</p>
   </td>
  </tr>
 </tbody>
</table>

<p><code>window.performance.navigation.redirectCount 表示到达最终页面前，重定向的次数（如果有的话）。</code></p>

<p>Navigation Timing API 可以用于收集客户端性能数据，然后通过 XHR 发送给服务端。还可以计算那些其他方法难以计算的数据，如卸载( unload )上一个页面的时间、域名查找时间、window.onload 的总时间等等。</p>

<h2 id="示例">示例</h2>

<p>计算页面加载所需的总时长：</p>

<pre>var perfData = window.performance.timing;
var pageLoadTime = perfData.loadEventEnd - perfData.navigationStart;
</pre>

<p>计算请求返回时长：</p>

<pre>var connectTime = perfData.responseEnd - perfData.requestStart;</pre>

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

<ul>
 <li><a class="external" href="http://www.w3.org/TR/navigation-timing/" title="http://www.w3.org/TR/navigation-timing/">https://w3c.github.io/navigation-timing/</a></li>
</ul>

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

<p>{{ CompatibilityTable }}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>6.0</td>
   <td>{{ CompatGeckoDesktop("7") }}</td>
   <td>9</td>
   <td>15.0</td>
   <td>8</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>4.0</td>
   <td>{{ CompatGeckoDesktop("15") }}</td>
   <td>9</td>
   <td>15.0</td>
   <td>8</td>
  </tr>
 </tbody>
</table>
</div>