Revision 1030574 of IDBDatabaseException

<div>{{APIRef("IndexedDB")}}</div>

<div class="warning style-wrap">
<p><strong>Obsolete:</strong> This interface was removed from the specification and was replaced by usage of {{ domxref("DOMException") }}.</p>
</div>

<p>In the <a href="/en/IndexedDB" title="en/IndexedDB">IndexedDB API</a>, an <code>IDBDatabaseException</code> object represents exception conditions that can be encountered while performing database operations.</p>

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

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Attribute</th>
   <th scope="col">Type</th>
   <th scope="col">Description</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><a name="attr_code"><code>code</code></a></td>
   <td><code>unsigned short</code></td>
   <td>The most appropriate error code for the condition.</td>
  </tr>
  <tr>
   <td><a name="attr_message"><code>message</code></a></td>
   <td><code>DOMString</code></td>
   <td>Error message describing the exception raised.</td>
  </tr>
 </tbody>
</table>

<h2 id="Constants">Constants</h2>

<p>{{ Note("Do not rely on the numeric values of the constants, which might change as the specifications continue to change. Use the constant names instead.&nbsp;") }}</p>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Constant</th>
   <th scope="col">Value</th>
   <th scope="col">Description</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code><a name="ABORT_ERR">ABORT_ERR</a></code></td>
   <td><code>8</code></td>
   <td>A request was aborted, for example, through a call to<a href="/en/IndexedDB/IDBTransaction#abort" title="en/IndexedDB/IDBTransaction#abort"> <code>IDBTransaction.abort</code></a>.</td>
  </tr>
  <tr>
   <td><code><a name="CONSTRAINT_ERR">CONSTRAINT_ERR</a></code></td>
   <td><code>4</code></td>
   <td>A mutation operation in the transaction failed because a constraint was not satisfied. For example, an object, such as an object store or index, already exists and a request attempted to create a new one.</td>
  </tr>
  <tr>
   <td><code><a name="DATA_ERR">DATA_ERR</a></code></td>
   <td><code>5</code></td>
   <td>Data provided to an operation does not meet requirements.</td>
  </tr>
  <tr>
   <td><code><a name="NON_TRANSIENT_ERR">NON_TRANSIENT_ERR</a></code></td>
   <td><code>2</code></td>
   <td>An operation was not allowed on an object. Unless the cause of the error is corrected, retrying the same operation would result in failure.</td>
  </tr>
  <tr>
   <td><code><a name="NOT_ALLOWED_ERR">NOT_ALLOWED_ERR</a></code></td>
   <td><code>6</code></td>
   <td>
    <p>An operation was called on an object where it is not allowed or at a time when it is not allowed. It also occurs if a request is made on a source object that has been deleted or removed.</p>

    <p>More specific variants of this error includes: <code> TRANSACTION_INACTIVE_ERR</code> and <code>READ_ONLY_ERR</code>.</p>
   </td>
  </tr>
  <tr>
   <td><code><a name="NOT_FOUND_ERR">NOT_FOUND_ERR</a></code></td>
   <td><code>3</code></td>
   <td>The operation failed because the requested database object could not be found; for example, an object store did not exist but was being opened.</td>
  </tr>
  <tr>
   <td><code><a name="QUOTA_ERR">QUOTA_ERR</a></code></td>
   <td><code>11</code></td>
   <td>Either there's not enough remaining storage space or the storage quota was reached and the user declined to give more space to the database.</td>
  </tr>
  <tr>
   <td><code><a name="READ_ONLY_ERR">READ_ONLY_ERR</a></code></td>
   <td><code>9</code></td>
   <td>A mutation operation was attempted in a <code>READ_ONLY</code>&nbsp;transaction.</td>
  </tr>
  <tr>
   <td><code><a name="TIMEOUT_ERR">TIMEOUT_ERR</a></code></td>
   <td><code>10</code></td>
   <td>A lock for the transaction could not be obtained in a reasonable time.</td>
  </tr>
  <tr>
   <td><a name="TRANSACTION_INACTIVE_ERR"><code>TRANSACTION_INACTIVE_ERR</code></a></td>
   <td><code>7</code></td>
   <td>A request was made against a transaction that is either not currently active or is already finished.</td>
  </tr>
  <tr>
   <td><code><a name="UNKNOWN_ERR">UNKNOWN_ERR</a></code></td>
   <td><code>1</code></td>
   <td>The operation failed for reasons unrelated to the database itself, and it is not covered by any other error code--for example, a failure due to disk IO errors.</td>
  </tr>
  <tr>
   <td><code><a name="VER_ERR">VER_ERR</a></code></td>
   <td><code>12</code></td>
   <td>A request to open a database with a version lower than the one it already has. This can only happen with <a href="/en/IndexedDB/IDBOpenDBRequest" title="en/IndexedDB/IDBOpenDBRequest"><code>IDBOpenDBRequest</code></a>.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_Compatibility" name="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 (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>12 {{ property_prefix("-webkit") }}</td>
   <td>{{ CompatGeckoDesktop("2.0") }} {{ Obsolete_inline("Gecko 14") }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
  </tr>
  <tr>
   <td><code>VER_ERR</code></td>
   <td>{{ CompatNo }}</td>
   <td>{{ CompatGeckoDesktop("10.0") }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</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&nbsp;Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatGeckoMobile("2.0") }} {{ Obsolete_inline("Gecko 14") }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
  </tr>
  <tr>
   <td><code>VER_ERR</code></td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatGeckoMobile("10.0") }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
  </tr>
 </tbody>
</table>
</div>

<p>&nbsp;</p>