XMLHttpRequest:timeout 属性

基线 广泛可用

此功能已发展成熟,可在许多设备和浏览器版本中使用。它从以下时间开始在所有浏览器中可用 2015 年 7 月.

注意: 此功能在 Web 工作线程 中可用,但 服务工作线程 除外。

XMLHttpRequest.timeout 属性是一个 unsigned long,表示请求在自动终止之前可以持续的毫秒数。默认值为 0,表示没有超时。超时不应该用于在 文档环境 中使用的同步 XMLHttpRequests 请求,否则会抛出 InvalidAccessError 异常。发生超时时,将触发 超时 事件。

注意: 您不能对拥有窗口的同步请求使用超时。

对异步请求使用超时.

示例

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。