Beacon API

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.

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

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

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

备注： Beacon API 在 Web Worker 中是不可用的（没有通过 WorkerNavigator 暴露出来）。

接口

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

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

规范

Specification
Beacon
# sendbeacon-method

浏览器兼容性

BCD tables only load in the browser

参见