---
title: HTMLMediaElement.onerror
slug: Web/API/HTMLMediaElement/onerror
translation_of: Web/API/HTMLMediaElement/onerror
---
<div>{{APIRef("HTML DOM")}}</div>

<p>The <strong><code>onerror</code></strong> property of the {{domxref("HTMLMediaElement")}} interface is the {{event("Event_handlers", "event handler")}} for processing {{event("error")}} events.</p>

<p>The <code>error</code> event fires when some form of error occurs while attempting to load or perform the media.</p>

<h2 id="Syntax" name="Syntax">语法</h2>

<pre class="syntaxbox"><em>HTMLMediaElement</em>.onerror = <em>EventListener</em>;</pre>

<h3 id="Value">Value</h3>

<p>A {{jsxref("function")}} which serves as the event handler for the {{event("error")}} event. When an error occurs, the specified function will be called. If <code>null</code>, no error handler is in effect.</p>

<h2 id="Specifications">Specifications</h2>

<table class="spectable standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG','webappapis.html#handler-onerror','onerror')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>



<p>{{Compat("api.HTMLMediaElement.onerror")}}</p>

<h2 id="See_also">See also</h2>

<ul>
 <li>{{domxref("HTMLMediaElement")}}</li>
 <li>{{HTMLElement("audio")}} and {{HTMLElement("video")}}</li>
</ul>