aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/xmlhttprequest/timeout/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/zh-cn/web/api/xmlhttprequest/timeout/index.html')
-rw-r--r--files/zh-cn/web/api/xmlhttprequest/timeout/index.html53
1 files changed, 53 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/xmlhttprequest/timeout/index.html b/files/zh-cn/web/api/xmlhttprequest/timeout/index.html
new file mode 100644
index 0000000000..941372fdf5
--- /dev/null
+++ b/files/zh-cn/web/api/xmlhttprequest/timeout/index.html
@@ -0,0 +1,53 @@
+---
+title: XMLHttpRequest.timeout
+slug: Web/API/XMLHttpRequest/timeout
+tags:
+ - AJAX
+ - XMLHttpRequest
+translation_of: Web/API/XMLHttpRequest/timeout
+---
+<div>{{APIRef('XMLHttpRequest')}}</div>
+
+<p><code><strong>XMLHttpRequest.timeout</strong></code> 是一个无符号长整型数,代表着一个请求在被自动终止前所消耗的毫秒数。默认值为 0,意味着没有超时。超时并不应该用在一个 {{Glossary('document environment')}} 中的同步 XMLHttpRequests  请求中,否则将会抛出一个 <code>InvalidAccessError</code> 类型的错误。当超时发生, <a href="/zh-CN/docs/Web/Events/timeout">timeout</a> 事件将会被触发。{{gecko_minversion_inline("12.0")}}</p>
+
+<div class="note">
+<p><strong>注意</strong>:你不能在拥有的window中,给同步请求使用超时。</p>
+</div>
+
+<p><a href="https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest/Synchronous_and_Asynchronous_Requests#.E4.BE.8B.E5.AD.90.3A_.E4.BD.BF.E7.94.A8.E8.B6.85.E6.97.B6">在异步请求中使用 timeout</a></p>
+
+<p>在IE中,超时属性可能只能在调用 <a href="/zh-CN/docs/Web/API/XMLHttpRequest/open">open()</a> 方法之后且在调用 <a href="/zh-CN/docs/Web/API/XMLHttpRequest/send">send()</a> 方法之前设置。</p>
+
+<h2 id="示例">示例</h2>
+
+<pre><code>var xhr = new XMLHttpRequest();
+xhr.open('GET', '/server', true);
+
+xhr.timeout = 2000; // 超时时间,单位是毫秒
+
+xhr.onload = function () {
+ // 请求完成。在此进行处理。
+};
+
+xhr.ontimeout = function (e) {
+ // XMLHttpRequest 超时。在此做某事。
+};
+
+xhr.send(null);</code></pre>
+
+<h2 id="规范">规范</h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <th scope="col"><font><font>规范</font></font></th>
+ <th scope="col">状态</th>
+ <th scope="col">注释</th>
+ </tr>
+ <tr>
+ <td>{{SpecName('XMLHttpRequest', '#the-timeout-attribute')}}</td>
+ <td>{{Spec2('XMLHttpRequest')}}</td>
+ <td><font><font>WHATW G</font></font>living standard</td>
+ </tr>
+ </tbody>
+</table>