XMLHttpRequest:timeout 屬性

Baseline 已廣泛支援

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

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

XMLHttpRequest.timeout 屬性是一個 unsigned long,表示請求在自動終止之前可以花費的毫秒數。預設值為 0,表示沒有超時。超時不應用於在文件環境中使用的同步 XMLHttpRequest 請求,否則會丟擲 InvalidAccessError 異常。發生超時時,會觸發一個 timeout 事件。

注意: 對於擁有視窗的同步請求,不能使用超時。

將超時與非同步請求一起使用.

示例

js
const xhr = new XMLHttpRequest();
xhr.open("GET", "/server", true);

xhr.timeout = 2000; // time in milliseconds

xhr.onload = () => {
  // Request finished. Do processing here.
};

xhr.ontimeout = (e) => {
  // XMLHttpRequest timed out. Do something here.
};

xhr.send(null);

規範

規範
XMLHttpRequest
# the-timeout-attribute

瀏覽器相容性