大网数据广告活动
Web 标准与前端开发

Event:timeStamp 属性

· 52CE 我爱测

Event 接口的 **`timeStamp`** 只读属性返回事件创建的时间(以毫秒为单位)。

DOM

Event 接口的 timeStamp 只读属性返回事件创建的时间(以毫秒为单位)。

值

该值是从时间原点开始到创建事件的毫秒数。如果全局对象是 Window,则时间原点是用户单击链接或脚本使文档开始加载的时刻。在 worker 中,时间原点是 worker 被创建的时刻。

该值是一个精确到 5 微秒(0.005 ms)的 DOMHighResTimeStamp,但为了防止指纹识别,其精度已被降低。

示例

HTML

<p>聚焦此 iframe 并按任意键即可获取按键事件当前的时间戳。</p>
<p>时间戳:<span id="time">—</span></p>

JavaScript

function getTime(event) {
  const time = document.getElementById("time");
  time.firstChild.nodeValue = event.timeStamp;
}
document.body.addEventListener("keypress", getTime);

结果

示例

降低时间精度

为了提供对时序攻击和指纹识别的保护,Event.timeStamp 的精度可能会根据浏览器设置而被舍入。

在 Firefox 中,privacy.reduceTimerPrecision 首选项默认启用,且默认值为 2 毫秒。

// Firefox 中降低后的时间精度(默认:2ms)
event.timeStamp;
// 9934
// 10362
// 11670
// …

在 Firefox 中,如果你还启用了 privacy.resistFingerprinting,则精度将为 100 毫秒或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds 的值中的较大者。

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。