XMLHttpRequest:超時事件

基線 廣泛可用

此功能已得到很好的確立,並且可以在許多裝置和瀏覽器版本上執行。它自以下時間起在瀏覽器中可用: 2015 年 7 月.

注意:此功能在 Web 工作執行緒 中可用,但 服務工作執行緒 除外。

timeout 事件在預設時間到期導致進度終止時觸發。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

js
addEventListener("timeout", (event) => {});

ontimeout = (event) => {};

事件型別

事件屬性

除了下面列出的屬性之外,父介面 Event 的屬性也可用。

lengthComputable 只讀

一個布林標誌,指示基礎程序要完成的總工作量以及已完成的工作量是否可計算。換句話說,它告訴進度是否可衡量。

loaded 只讀

一個 64 位無符號整數,指示基礎程序已執行的工作量。已完成的工作比例可以透過將此屬性的值除以 total 來計算。在使用 HTTP 下載資源時,這僅計算 HTTP 訊息的主體,不包括標頭和其他開銷。

total 只讀

一個 64 位無符號整數,表示基礎程序正在執行的總工作量。在使用 HTTP 下載資源時,這是 Content-Length(訊息主體的尺寸),不包括標頭和其他開銷。

示例

js
const client = new XMLHttpRequest();
client.open("GET", "http://www.example.org/example.txt");
client.ontimeout = () => {
  console.error("Timeout!!");
};

client.send();

您還可以使用 addEventListener() 方法設定事件處理程式

js
client.addEventListener("timeout", () => {
  console.error("Timeout!!");
});

規範

規範
XMLHttpRequest 標準
# event-xhr-timeout
XMLHttpRequest 標準
# handler-xhr-ontimeout

瀏覽器相容性

BCD 表格僅在啟用 JavaScript 的瀏覽器中載入。

另請參閱