---
title: Performance.measure()
slug: Web/API/Performance/measure
tags:
  - Performance API
  - 网页性能
translation_of: Web/API/Performance/measure
---
<div>{{APIRef("User Timing API")}}</div>

<p> <strong><code>measure()</code></strong> 方法在浏览器性能记录缓存中创建了一个名为{{domxref("DOMHighResTimeStamp","时间戳")}}的记录来记录两个特殊标志位（通常称为开始标志和结束标志）。 被命名的{{domxref("DOMHighResTimeStamp","时间戳")}}称为一次测量（measure）。</p>

<p>{{AvailableInWorkers}}</p>

<p>The <code>measure</code> 可以被{{domxref("Performance")}} 接口 <code>getEntries*()</code> 中的方法检查到({{domxref("Performance.getEntries","getEntries()")}}, {{domxref("Performance.getEntriesByName","getEntriesByName()")}} 或者 {{domxref("Performance.getEntriesByType","getEntriesByType()")}}).</p>

<p>The <code>measure's</code> {{domxref("PerformanceEntry","performance entry")}} will have the following property values:</p>

<ul>
 <li>{{domxref("PerformanceEntry.entryType","entryType")}} - set to "<code>measure</code>".</li>
 <li>{{domxref("PerformanceEntry.name","name")}} - set to the "<code>name</code>" given when the measure was created.</li>
 <li>{{domxref("PerformanceEntry.startTime","startTime")}} - set to the start mark {{domxref("DOMHighResTimeStamp","timestamp")}}.</li>
 <li>{{domxref("PerformanceEntry.duration","duration")}} - set to a {{domxref("DOMHighResTimeStamp")}} that is the duration of the measure (typically, the end mark timestamp minus the start mark timestamp).</li>
</ul>

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

<pre class="syntaxbox"><em>performance</em>.measure(name, startMark, endMark);
</pre>

<h3 id="参数">参数</h3>

<dl>
 <dt>name</dt>
 <dd>一个 {{domxref("DOMString")}}， 代表测量的名字。</dd>
 <dt>startMark {{optional_inline}}</dt>
 <dd>一个 {{domxref("DOMString")}}， 代表测量的开始标志名字。 May also be the name of a {{domxref("PerformanceTiming")}} property.</dd>
 <dt>endMark {{optional_inline}}</dt>
 <dd>一个{{domxref("DOMString")}}， 代表测量的结束标志名字。May also be the name of a {{domxref("PerformanceTiming")}} property.</dd>
</dl>

<h3 id="返回值">返回值</h3>

<dl>
 <dt>void</dt>
 <dd> </dd>
</dl>

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

<p>以下例子展示如何在浏览器性能记录缓存中使用 <code>measure()</code>创建一个新的测量记录{{domxref("PerformanceEntry","performance entry")}} 。</p>

<pre class="brush: js">// 以一个标志开始。
performance.mark("mySetTimeout-start");

// 等待一些时间。
setTimeout(function() {
  // 标志时间的结束。
  performance.mark("mySetTimeout-end");

  // 测量两个不同的标志。
  performance.measure(
    "mySetTimeout",
    "mySetTimeout-start",
    "mySetTimeout-end"
  );

  // 获取所有的测量输出。
  // 在这个例子中只有一个。
  var measures = performance.getEntriesByName("mySetTimeout");
  var measure = measures[0];
  console.log("setTimeout milliseconds:", measure.duration)

  // 清除存储的标志位
  performance.clearMarks();
  performance.clearMeasures();
}, 1000);
</pre>

<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('User Timing Level 2', '#dom-performance-measure', 'measure()')}}</td>
   <td>{{Spec2('User Timing Level 2')}}</td>
   <td>Clarifies <code>measure()</code> processing model.</td>
  </tr>
  <tr>
   <td>{{SpecName('User Timing', '#dom-performance-measure', 'measure()')}}</td>
   <td>{{Spec2('User Timing')}}</td>
   <td>Basic definition.</td>
  </tr>
 </tbody>
</table>

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

<div>


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