請求:keepalive 屬性

Baseline 2024
新推出

自 ⁨2024 年 11 月⁩ 以來,此功能在最新的裝置和瀏覽器版本中均可正常工作。此功能在舊裝置或瀏覽器中可能無法正常工作。

keepaliveRequest 介面的一個只讀屬性,包含請求的 keepalive 設定(truefalse),指示在發起請求的頁面解除安裝之前,瀏覽器是否會保持關聯請求的活動狀態,直到請求完成。

這使得 fetch() 請求能夠在頁面解除安裝後(例如,使用者離開或關閉頁面)傳送分析資料。與使用 Navigator.sendBeacon() 執行相同目的相比,它具有一些優勢,包括允許您使用除 POST 之外的其他 HTTP 方法,自定義請求屬性,並透過 fetch 的 Promise fulfilled 來訪問伺服器響應。它也可在 Service Workers 中使用。

一個布林值,指示請求的 keepalive 狀態。

示例

使用 keepalive 建立請求

在下面的程式碼片段中,我們使用 keepalive 設定為 trueRequest() 建構函式建立了一個新請求,然後將請求的 keepalive 值儲存在一個變數中。

js
const options = {
  keepalive: true,
};

const myRequest = new Request("flowers.jpg", options);
let myKeepAlive = myRequest.keepalive; // true

規範

規範
Fetch
# ref-for-dom-request-keepalive②

瀏覽器相容性

另見