Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Revision 974259 of PerformanceMeasure

  • Revision slug: Web/API/PerformanceMeasure
  • Revision title: PerformanceMeasure
  • Revision id: 974259
  • Created:
  • Creator: AFBarstow
  • Is current revision? No
  • Comment Fix URL fragment bug

Revision Content

{{APIRef("User Timing API")}}

PerformanceMeasure is an abstract interface for {{domxref("PerformanceEntry","performance entries")}} with an {{domxref("PerformanceEntry.entryType","entry type")}} of "measure". Entries of this type are created by calling {{domxref("Performance.measure","performance.measure()")}} to add a named {{domxref("DOMHighResTimeStamp","timestamp")}} (the measure) between two marks to the browser's performance timeline.

The PerformanceMeasure interface has no properties, no methods nor any constructors. However, it qualifies and constrains the following {{domxref("PerformanceEntry")}} properties for "measure" type {{domxref("PerformanceEntry","performance entries")}}: {{domxref("PerformanceEntry.name","name")}}, {{domxref("PerformanceEntry.entryType","entryType")}}, {{domxref("PerformanceEntry.startTime","startTime")}} and {{domxref("PerformanceEntry.duration","duration")}}.

Properties

This interface has no properties but it extends the following {{domxref("PerformanceEntry")}} properties by qualifying/constrainting the properties as follows:

{{domxref("PerformanceEntry.entryType","entryType")}}
Set to "measure".
{{domxref("PerformanceEntry.name","name")}}
Set to the name given to the measure when it was created via a call to {{domxref("Performance.measure()","performance.measure()")}}.
{{domxref("PerformanceEntry.startTime","startTime")}}
Set to the {{domxref("DOMHighResTimeStamp","timestamp")}} when {{domxref("Performance.measure()","performance.measure()")}} was called.
{{domxref("PerformanceEntry.duration","duration")}}
Set to a {{domxref("DOMHighResTimeStamp")}} that is the duration of the measure (typically, the measure's end mark timestamp minus its start mark timestamp).

Methods

This interface has no methods.

Example

See the example in Using the User Timing API.

Specifications

Specification Status Comment
{{SpecName('User Timing Level 2', '#dom-performance-measure', 'PerformanceMeasure')}} {{Spec2('User Timing Level 2')}}  
{{SpecName('User Timing', '#performancemeasure', 'PerformanceMeasure')}} {{Spec2('User Timing')}} Basic definition.

Browser compatibility

{{CompatibilityTable}}
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support. 43 41 10 33 {{CompatNo}}
Feature Android Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile
Basic support. 46 42 42 10 33 {{CompatNo}}

See also

Revision Source

<div>{{APIRef("User Timing API")}}</div>

<p><code><strong>PerformanceMeasure</strong></code> is an <em>abstract</em> interface for {{domxref("PerformanceEntry","performance entries")}} with an {{domxref("PerformanceEntry.entryType","entry type")}} of "<code>measure</code>". Entries of this type are created by calling {{domxref("Performance.measure","performance.measure()")}} to add a <em>named</em> {{domxref("DOMHighResTimeStamp","timestamp")}} (the <em>measure</em>) between two <em>marks</em> to the browser's <em>performance timeline</em>.</p>

<p class="note">The <code>PerformanceMeasure</code> interface has no properties, no methods nor any constructors. However, it qualifies and constrains the following {{domxref("PerformanceEntry")}} properties for "<code>measure</code>" type {{domxref("PerformanceEntry","performance entries")}}: {{domxref("PerformanceEntry.name","name")}}, {{domxref("PerformanceEntry.entryType","entryType")}}, {{domxref("PerformanceEntry.startTime","startTime")}} and {{domxref("PerformanceEntry.duration","duration")}}.</p>

<h2 id="Properties">Properties</h2>

<p>This interface has no properties but it extends the following {{domxref("PerformanceEntry")}} properties by qualifying/constrainting the properties as follows:</p>

<dl>
 <dt>{{domxref("PerformanceEntry.entryType","entryType")}}</dt>
 <dd>Set to "<code>measure</code>".</dd>
 <dt>{{domxref("PerformanceEntry.name","name")}}</dt>
 <dd>Set to the <code>name</code> given to the measure when it was created via a call to {{domxref("Performance.measure()","performance.measure()")}}.</dd>
 <dt>{{domxref("PerformanceEntry.startTime","startTime")}}</dt>
 <dd>Set to the {{domxref("DOMHighResTimeStamp","timestamp")}} when {{domxref("Performance.measure()","performance.measure()")}} was called.</dd>
 <dt>{{domxref("PerformanceEntry.duration","duration")}}</dt>
 <dd>Set to a {{domxref("DOMHighResTimeStamp")}} that is the duration of the measure (typically, the measure's end mark timestamp minus its start mark timestamp).</dd>
</dl>

<h2 id="Methods">Methods</h2>

<p>This interface has no methods.</p>

<h2 id="Example">Example</h2>

<p>See the example in <a href="/Web/API/User_Timing_API/Using_the_User_Timing_API">Using the User Timing API</a>.</p>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('User Timing Level 2', '#dom-performance-measure', 'PerformanceMeasure')}}</td>
   <td>{{Spec2('User Timing Level 2')}}</td>
   <td>&nbsp;</td>
  </tr>
  <tr>
   <td>{{SpecName('User Timing', '#performancemeasure', 'PerformanceMeasure')}}</td>
   <td>{{Spec2('User Timing')}}</td>
   <td>Basic definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>

<div>{{CompatibilityTable}}</div>

<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 (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support.</td>
   <td>43</td>
   <td>41</td>
   <td>10</td>
   <td>33</td>
   <td>{{CompatNo}}</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>Firefox OS</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support.</td>
   <td>46</td>
   <td>42</td>
   <td>42</td>
   <td>10</td>
   <td>33</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="See_also">See also</h2>

<ul>
 <li><a href="/Web/API/User_Timing_API">User Timing (Overview)</a></li>
 <li><a href="/Web/API/User_Timing_API/Using_the_User_Timing_API">Using the User Timing API</a></li>
</ul>
Revert to this revision