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

Beacon API

· 52CE 我爱测

`Beacon`** API 用于发送异步和非阻塞请求到服务器。这类请求不需要响应。与 XMLHttpRequest 或 Fetch API 请求不同,浏览器会保证在页面卸载前,将信标请求初始化并运行完成。

Beacon

Beacon API 用于发送异步和非阻塞请求到服务器。这类请求不需要响应。与 XMLHttpRequest 或 Fetch API 请求不同,浏览器会保证在页面卸载前,将信标请求初始化并运行完成。

Beacon API 主要的使用场景是将分析数据发送给服务器,如:客户端事件、会话数据等。在过去,网站使用 XMLHttpRequest 来做这件事,但是浏览器无法保证在某些情况发送这些请求(如:页面将被卸载)。为了解决这个问题,网站采取了各种各样的技术,例如使用同步请求,但是这样对性能造成了很糟糕的影响。因为信标请求是异步的并且保证发送,所以它们结合了良好的性能特征和可靠性。

如需了解 Beacon API 更多的细节和用例,请参考 navigator.sendBeacon() 方法。

[!NOTE] Beacon API 在 Web Worker 中是不可用的(没有通过 WorkerNavigator 暴露出来)。

接口

Beacon API 定义了一个独立的方法:navigator.sendBeacon()。

该方法接受 2 个参数,URL 和要在请求中发送的数据(data)。data 参数是可选的,其类型可以是 TypedArray、DataView、Blob、字符串字面量、普通对象或 FormData 对象。如果浏览器成功地将请求排队交付,则该方法返回“true”,否则返回“false”。

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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