Request: keepalive property
The keepalive
read-only property of the Request
interface contains the request's keepalive
setting (true
or false
), which indicates whether the browser will keep the associated request alive if the page that initiated it is unloaded before the request is complete.
This enables a fetch()
request to function as an alternative to Navigator.sendBeacon()
when sending analytics at the end of a session, which has some advantages (you can use HTTP methods other than POST
, customize request properties, and access the server response via the fetch Promise
fulfillment). It is also available in service workers.
Value
A boolean value indicating the keepalive
status of the request.
Examples
In the following snippet, we create a new request using the Request()
constructor with keepalive
set to true
, then save the keepalive
value of the request in a variable:
const options = {
keepalive: true,
};
const myRequest = new Request("flowers.jpg", options);
let myKeepAlive = myRequest.keepalive; // true
Specifications
Specification |
---|
Fetch Standard # ref-for-dom-request-keepalive② |
Browser compatibility
BCD tables only load in the browser