XMLHttpRequest:abort() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能在 Web Workers 中可用,但 Service Workers 除外。

XMLHttpRequest.abort() 方法會中止已傳送的請求。當請求被中止時,其 readyState 會被更改為 XMLHttpRequest.UNSENT (0),並且請求的 status 程式碼會被設定為 0。

如果請求仍在進行中(其 readyState 不是 XMLHttpRequest.DONEXMLHttpRequest.UNSENT),則會按順序分派 readystatechange 事件、abort 事件和 loadend 事件。對於同步請求,不會分派任何事件,而是會丟擲錯誤。

語法

js
abort()

引數

無。

返回值

無(undefined)。

示例

此示例開始載入 MDN 主頁的內容,然後由於某種條件,透過呼叫 abort() 來中止傳輸。

js
const xhr = new XMLHttpRequest();
const method = "GET";
const url = "https://mdn.club.tw/";
xhr.open(method, url, true);

xhr.send();

if (OH_NOES_WE_NEED_TO_CANCEL_RIGHT_NOW_OR_ELSE) {
  xhr.abort();
}

規範

規範
XMLHttpRequest
# the-abort()-method

瀏覽器相容性

另見