DOMHighResTimeStamp
type is a
double
and is used to store a time value in milliseconds.
This type can be used to describe a discrete point in time or a time interval (the difference in time between two discrete points in time).
The time, given in milliseconds, should be accurate to 5 µs (microseconds), with the fractional part of the number indicating fractions of a millisecond. However, if the browser is unable to provide a time value accurate to 5 µs (due, for example, to hardware or software constraints), the browser can represent the value as a time in milliseconds accurate to a millisecond. Also note the section below on reduced time precision controlled by browser preferences to avoid timing attacks and fingerprinting.
Further, if the device or operating system the user agent is running on doesn't have a clock accurate to the microsecond level, they may only be accurate to the millisecond.
To offer protection against timing attacks and fingerprinting, the precision of time stamps might get rounded depending on browser settings. In Firefox, the
privacy.reduceTimerPrecision
preference is enabled by default and defaults to 20 µs in Firefox 59; in 60 it will be 2ms.
// reduced time precision (2ms) in Firefox 60 event.timeStamp // 1519211809934 // 1519211810362 // 1519211811670 // ... // reduced time precision with `privacy.resistFingerprinting` enabled event.timeStamp; // 1519129853500 // 1519129858900 // 1519129864400 // ...
In Firefox, you can also enable
privacy.resistFingerprinting
, the precision will be 100ms or the value of
privacy.resistFingerprinting.reduceTimerPrecision.microseconds
, whichever is larger.
This type has no properties. It is a double-precision floating-point value.
The value of a
DOMHighResTimeStamp
is a double-precision floating-point number which describes the number of milliseconds (accurate to within 5 microseconds if the device supports it) elapsed between two points in time. The starting time can be either a specific time determined by the script for a site or app, or the
time origin
.
time origin is a standard time which is considered to be the beginning of the current document's lifetime. It's calculated like this:
Window
, the time origin is determined as follows:
Document
is the first one loaded in the
Window
, the time origin is the time at which the browser context was created.
Document
took place.
WorkerGlobalScope
(that is, the script is running as a web worker), the time origin is the moment at which the worker was created.
This type has no methods.
You can get the current timestamp value—the time that has elapsed since the context was created—by calling the
性能
方法
now()
. This method is available in both
Window
and
Worker
上下文。
To determine how much time has elapsed since a particular point in your code, you can do something like this:
let startTime = performance.now(); /* ... do things for a while ... */ let elapsedTime = performance.now() - startTime;
Upon completion, the value of
elapsedTime
is the number of milliseconds that have elapsed since you recorded the starting time in line 1.
| 规范 | 状态 | 注释 |
|---|---|---|
|
High Resolution Time Level 2
The definition of 'DOMHighResTimeStamp' in that specification. |
推荐 | Stricter definitions of interfaces and types. |
|
高分辨率时间
The definition of 'DOMHighResTimeStamp' in that specification. |
推荐 | 初始定义。 |
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
DOMHighResTimestamp
|
Chrome 6 | Edge 12 | Firefox 7 | IE 9 | Opera 15 | Safari 8 | WebView Android Yes | Chrome Android 18 | Firefox Android 15 | Opera Android 14 | Safari iOS 9 | Samsung Internet Android 1.0 |
完整支持
DOMHighResTimeStamp