---
title: 'XMLHttpRequest: error 事件'
slug: Web/API/XMLHttpRequest/error_event
translation_of: Web/API/XMLHttpRequest/error_event
---
<div>{{APIRef}}</div>

<p><span>当请求遇到错误时，将触发</span><code>error</code> 事件。</p>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row">可冒泡</th>
   <td>No</td>
  </tr>
  <tr>
   <th scope="row">可取消</th>
   <td>No</td>
  </tr>
  <tr>
   <th scope="row">接口</th>
   <td>{{domxref("ProgressEvent")}}</td>
  </tr>
  <tr>
   <th scope="row">事件处理程序属性</th>
   <td>{{domxref("XMLHttpRequestEventTarget/onerror", "onerror")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="示例">示例</h2>

<h3 id="在线示例">在线示例</h3>

<h4 id="HTML">HTML</h4>

<pre class="brush: html">&lt;div class="controls"&gt;
    &lt;input class="xhr success" type="button" name="xhr" value="Click to start XHR (success)" /&gt;
    &lt;input class="xhr error" type="button" name="xhr" value="Click to start XHR (error)" /&gt;
    &lt;input class="xhr abort" type="button" name="xhr" value="Click to start XHR (abort)" /&gt;
&lt;/div&gt;

&lt;textarea readonly class="event-log"&gt;&lt;/textarea&gt;</pre>

<div class="hidden">
<h4 id="CSS">CSS</h4>

<pre class="brush: css">.event-log {
    width: 25rem;
    height: 4rem;
    border: 1px solid black;
    margin: .5rem;
    padding: .2rem;
}

input {
    width: 11rem;
    margin: .5rem;
}
</pre>
</div>

<h4 id="JS">JS</h4>

<pre class="brush: js">const xhrButtonSuccess = document.querySelector('.xhr.success');
const xhrButtonError = document.querySelector('.xhr.error');
const xhrButtonAbort = document.querySelector('.xhr.abort');
const log = document.querySelector('.event-log');

function handleEvent(e) {
    log.textContent = log.textContent + `${e.type}: ${e.loaded} bytes transferred\n`;
}

function addListeners(xhr) {
    xhr.addEventListener('loadstart', handleEvent);
    xhr.addEventListener('load', handleEvent);
    xhr.addEventListener('loadend', handleEvent);
    xhr.addEventListener('progress', handleEvent);
    xhr.addEventListener('error', handleEvent);
    xhr.addEventListener('abort', handleEvent);
}

function runXHR(url) {
    log.textContent = '';

    const xhr = new XMLHttpRequest();
    addListeners(xhr);
    xhr.open("GET", url);
    xhr.send();
    return xhr;
}

xhrButtonSuccess.addEventListener('click', () =&gt; {
    runXHR('https://mdn.mozillademos.org/files/16553/DgsZYJNXcAIPwzy.jpg');
});

xhrButtonError.addEventListener('click', () =&gt; {
    runXHR('https://somewhere.org/i-dont-exist');
});

xhrButtonAbort.addEventListener('click', () =&gt; {
    runXHR('https://mdn.mozillademos.org/files/16553/DgsZYJNXcAIPwzy.jpg').abort();
});</pre>

<h4 id="结果">结果</h4>

<p>{{ EmbedLiveSample('在线示例', '100%', '150px') }}</p>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('XMLHttpRequest', '#event-xhr-error')}}</td>
   <td>{{Spec2('XMLHttpRequest')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>



<p>{{Compat("api.XMLHttpRequest.error_event")}}</p>

<h2 id="其他">其他</h2>

<ul>
 <li>相关事件: {{domxref("XMLHttpRequest/loadstart_event", "loadstart")}}, {{domxref("XMLHttpRequest/load_event", "load")}}, {{domxref("XMLHttpRequest/progress_event", "progress")}}, {{domxref("XMLHttpRequest/loadend_event", "loadend")}}, {{domxref("XMLHttpRequest/abort_event", "abort")}}</li>
 <li><a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest#Monitoring_progress">监视进度</a></li>
</ul>