注意： 此特征可用于 Web 工作者 .

句法

performance.measure(name);
performance.measure(name, startMark);
performance.measure(name, startMark, endMark);
performance.measure(name, undefined, endMark);
						

自变量

名称

DOMString representing the name of the measure.

startMark 可选

DOMString representing the name of the measure's starting mark. May also be the name of a PerformanceTiming property. If it is omitted, then the start time will be the navigation start time.

endMark 可选

DOMString representing the name of the measure's ending mark. May also be the name of a PerformanceTiming property. If it is omitted, then the current time is used.

返回值

void

范例

The following example shows how measure() is used to create a new measure performance entry in the browser's performance entry buffer.

const markerNameA = "example-marker-a"
const markerNameB = "example-marker-b"
// Run some nested timeouts, and create a PerformanceMark for each.
performance.mark(markerNameA);
setTimeout(function() {
  performance.mark(markerNameB);
  setTimeout(function() {
    // Create a variety of measurements.
    performance.measure("measure a to b", markerNameA, markerNameB);
    performance.measure("measure a to now", markerNameA);
    performance.measure("measure from navigation start to b", undefined, markerNameB);
    performance.measure("measure from the start of navigation to now");
    // Pull out all of the measurements.
    console.log(performance.getEntriesByType("measure"));
    // Finally, clean up the entries.
    performance.clearMarks();
    performance.clearMeasures();
  }, 1000);
}, 1000);
							

规范

规范	状态	注释
User Timing Level 2 The definition of 'measure()' in that specification.	工作草案	Clarifies measure() processing model.
User Timing The definition of 'measure()' in that specification.	推荐	Basic definition.

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
measure	Chrome 28 28 25 — 28 Prefixed Prefixed Implemented with the vendor prefix: webkit	Edge 12	Firefox 41	IE 10	Opera 33	Safari 11	WebView Android 46	Chrome Android 28 28 25 — 28 Prefixed Prefixed Implemented with the vendor prefix: webkit	Firefox Android 42	Opera Android 33	Safari iOS 11	Samsung Internet Android 1.5

图例

完整支持

完整支持

要求使用供应商前缀或不同名称。

要求使用供应商前缀或不同名称。

元数据

• 最后修改： Aug 16, 2019