XMLHttpRequest.timeout

XMLHttpRequest.timeout 是一个无符号长整型数,代表着一个请求在被自动终止前所消耗的毫秒数。默认值为 0,意味着没有超时。超时并不应该用在一个 document environment 中的同步 XMLHttpRequests  请求中,否则将会抛出一个 InvalidAccessError 类型的错误。当超时发生, timeout 事件将会被触发。

注意:你不能在拥有的window中,给同步请求使用超时。

在异步请求中使用 timeout

在IE中,超时属性可能只能在调用 open() 方法之后且在调用 send() 方法之前设置。

示例

var xhr = new XMLHttpRequest();
xhr.open('GET', '/server', true);
xhr.timeout = 2000; // 超时时间,单位是毫秒
xhr.onload = function () {
  // 请求完成。在此进行处理。
};
xhr.ontimeout = function (e) {
  // XMLHttpRequest 超时。在此做某事。
};
xhr.send(null);

规范

规范 状态 注释
XMLHttpRequest Living Standard WHATW Gliving standard

文档标签和贡献者