Revision 902685 of DOMException

<p>{{ APIRef("DOM") }}</p>

<p>The <code><strong>DOMException</strong></code> exception represents an abnormal event happening when a method or a property is used.</p>

<h2 id="Constructor">Constructor</h2>

<dl>
 <dt>{{domxref("DOMException.DOMException()", "DOMException()")}} {{experimental_inline}}</dt>
 <dd>Returns a <code>DOMException</code> object with a specified message and name.</dd>
</dl>

<h2 id="Attributes">Attributes</h2>

<dl>
 <dt>{{domxref("DOMException.code")}} {{ deprecated_inline() }} {{readOnlyInline}}</dt>
 <dd>Returns a <code>short</code> that contains one of the <a href="#Error_constants">error code constants</a>, or <code>0</code> if none match. This field is used for historical reasons, new kind of DOM exceptions don't use anymore: they put this info in the {{domxref("DOMException.name")}} attribute.</dd>
 <dt>{{domxref("DOMException.name")}} {{readOnlyInline}}</dt>
 <dd>Returns a {{domxref("DOMString")}} that contains one of the string associated with an <a href="#Error_constants">error constant</a>.</dd>
</dl>

<h2 id="Error_Constants"><a name="Error_constants"></a>Error Constants</h2>

<dl>
 <dt>{{exceptionAnchor("IndexSizeError")}}</dt>
 <dd>The index is not in the allowed range. For example, this can be thrown by {{ domxref("Range") }} object. (Legacy code value: <code>1</code> and legacy constant name: <code>INDEX_SIZE_ERR</code>)</dd>
 <dt>{{exceptionAnchor("HierarchyRequestError")}}</dt>
 <dd>The node tree hierarchy is not correct. (Legacy code value: <code>3</code> and legacy constant name: <code>HIERARCHY_REQUEST_ERR</code>)</dd>
 <dt>{{exceptionAnchor("WrongDocumentError")}}</dt>
 <dd>The object is in the wrong {{ domxref("Document") }}. (Legacy code value: <code>4</code> and legacy constant name: <code>WRONG_DOCUMENT_ERR</code>)</dd>
 <dt>{{exceptionAnchor("InvalidCharacterError")}}</dt>
 <dd>The string contains invalid characters. (Legacy code value: <code>5</code> and legacy constant name: <code>INVALID_CHARACTER_ERR</code>)</dd>
 <dt>{{exceptionAnchor("NoModificationAllowedError")}}</dt>
 <dd>The object can not be modified. (Legacy code value: <code>7</code> and legacy constant name: <code>NO_MODIFICATION_ALLOWED_ERR</code>)</dd>
 <dt>{{exceptionAnchor("NotFoundError")}}</dt>
 <dd>The object can not be found here. (Legacy code value: <code>8</code> and legacy constant name: <code>NOT_FOUND_ERR</code>)</dd>
 <dt>{{exceptionAnchor("NotSupportedError")}}</dt>
 <dd>The operation is not supported. (Legacy code value: <code>9</code> and legacy constant name: <code>NOT_SUPPORTED_ERR</code>)</dd>
 <dt>{{exceptionAnchor("InvalidStateError")}}</dt>
 <dd>The object is in an invalid state. (Legacy code value: <code>11</code> and legacy constant name: <code>INVALID_STATE_ERR</code>)</dd>
 <dt>{{exceptionAnchor("SyntaxError")}}</dt>
 <dd>The string did not match the expected pattern. (Legacy code value: <code>12</code> and legacy constant name: <code>SYNTAX_ERR</code>)</dd>
 <dt>{{exceptionAnchor("InvalidModificationError")}}</dt>
 <dd>The object can not be modified in this way. (Legacy code value: <code>13</code> and legacy constant name: <code>INVALID_MODIFICATION_ERR</code>)</dd>
 <dt>{{exceptionAnchor("NamespaceError")}}</dt>
 <dd>The operation is not allowed by Namespaces in XML. (Legacy code value: <code>14</code> and legacy constant name: <code>NAMESPACE_ERR</code>)</dd>
 <dt>{{exceptionAnchor("InvalidAccessError")}}</dt>
 <dd>The object does not support the operation or argument. (Legacy code value: <code>15</code> and legacy constant name: <code>INVALID_ACCESS_ERR</code>)</dd>
 <dt>{{exceptionAnchor("TypeMismatchError")}} {{deprecated_inline}}</dt>
 <dd>The type of the object does not match the expected type. (Legacy code value: <code>17</code> and legacy constant name: <code>TYPE_MISMATCH_ERR</code>) This value is deprecated, the JavaScript {{jsxref("TypeError")}} exception is now raised instead of a <code>DOMException</code> with this value.</dd>
 <dt>{{exceptionAnchor("SecurityError")}} {{experimental_inline}}</dt>
 <dd>The operation is insecure. (Legacy code value: <code>18</code> and legacy constant name: <code>SECURITY_ERR</code>)</dd>
 <dt>{{exceptionAnchor("NetworkError")}} {{experimental_inline}}</dt>
 <dd>A network error occurred. (Legacy code value: <code>19</code> and legacy constant name: <code>NETWORK_ER</code><code>R</code>)</dd>
 <dt>{{exceptionAnchor("AbortError")}} {{experimental_inline}}</dt>
 <dd>The operation was aborted. (Legacy code value: <code>20</code> and legacy constant name: <code>ABORT_ERR</code>)</dd>
 <dt>{{exceptionAnchor("URLMismatchError")}} {{experimental_inline}}</dt>
 <dd>The given URL does not match another URL. (Legacy code value: <code>21</code> and legacy constant name: <code>URL_MISMATCH_ERR</code>)</dd>
 <dt>{{exceptionAnchor("QuotaExceededError")}} {{experimental_inline}}</dt>
 <dd>The quota has been exceeded. (Legacy code value: <code>22</code> and legacy constant name: <code>QUOTA_EXCEEDED_ERR</code>)</dd>
 <dt>{{exceptionAnchor("TimeoutError")}} {{experimental_inline}}</dt>
 <dd>The operation timed out. (Legacy code value: <code>23</code> and legacy constant name: <code>TIMEOUT_ERR</code>)</dd>
 <dt>{{exceptionAnchor("InvalidNodeTypeError")}} {{experimental_inline}}</dt>
 <dd>The node is incorrect or has an incorrect ancestor for this operation. (Legacy code value: <code>24</code> and legacy constant name: <code>INVALID_NODE_TYPE_ERR</code>)</dd>
 <dt>{{exceptionAnchor("DataCloneError")}} {{experimental_inline}}</dt>
 <dd>The object can not be cloned. (Legacy code value: <code>25</code> and legacy constant name: <code>DATA_CLONE_ERR</code>)</dd>
 <dt>{{exceptionAnchor("EncodingError")}} {{experimental_inline}}</dt>
 <dd>The encoding operation, being an encoding or a decoding one, failed (No legacy code value and constant name).</dd>
 <dt>{{exceptionAnchor("NotReadableError")}} {{experimental_inline}}</dt>
 <dd>The input/output read operation failed (No legacy code value and constant name).</dd>
</dl>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('WebIDL', '#es-DOMException-call', 'constructor')}}</td>
   <td>{{Spec2('WebIDL')}}</td>
   <td>Adds the constructor for the <code>DOMException</code> class.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM WHATWG', '#exception-domexception', 'DOMException')}}</td>
   <td>{{Spec2('DOM WHATWG')}}</td>
   <td>Since the latest snapshot, {{SpecName("DOM4")}},&nbsp; and the <code>NotReadableError</code>value have been added.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM4', '#exception-domexception', 'DOMException')}}</td>
   <td>{{Spec2('DOM4')}}</td>
   <td>Added <code>SECURITY_ERR</code>, <code>NETWORK_ERR</code>, <code>ABORT_ERR</code>, <code>URL_MISMATCH_ERR</code>, <code>QUOTA_EXCEEDED_ERR</code>, <code>TIMEOUT_ERR</code>, <code>INVALID_NODE_TYPE_ERR</code>, and <code>DATA_CLONE_ERR</code>. The property <code>code</code> has been deprecated for exception values. The <code>EncodingError</code> value added.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM3 Core', 'core.html#ID-17189187', 'DOMException')}}</td>
   <td>{{Spec2('DOM3 Core')}}</td>
   <td>Added of <code>VALIDATION_ERR</code> and <code>TYPE_MISMATCH_ERR</code>.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM2 Core', 'core.html#ID-17189187', 'DOMException')}}</td>
   <td>{{Spec2('DOM2 Core')}}</td>
   <td>Added of <code>INVALID_STATE_ERR</code>, <code>SYNTAX_ERR</code>, <code>INVALID_MODIFICATION_ERR</code>, <code>NAMESPACE_ERR</code>, and <code>INVALID_ACCESS_ERR</code>.</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM1', 'level-one-core.html#ID-17189187', 'DOMException')}}</td>
   <td>{{Spec2('DOM1')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

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

<p>{{ CompatibilityTable() }}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatGeckoDesktop("1.0") }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
  <tr>
   <td>DOM Level 4 support</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatGeckoDesktop("13.0") }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
  <tr>
   <td><code>DATA_CLONE_ERR</code> constant</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatGeckoDesktop("5.0") }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatGeckoMobile("1.0") }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
  <tr>
   <td>DOM Level 4 support</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatGeckoMobile("13.0") }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
  <tr>
   <td><code>DATA_CLONE_ERR</code> constant</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatGeckoMobile("5.0") }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
 </tbody>
</table>
</div>

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

<ul>
 <li>{{ domxref("DOMError") }}</li>
</ul>