1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
---
title: DOMException
slug: Web/API/DOMException
translation_of: Web/API/DOMException
---
<p>{{ APIRef("DOM") }}</p>
<p>A interface <strong>DOMException </strong>representa um evento anormal (denominado de<strong> exceção</strong>) durante a chamada ou a espera de um resultado do metodo ou uma solicitação a uma web API. Basicamente, falando, é o tratamento dos erros e condições, dos mesmos, nos processos web.</p>
<p>Cada exceção tem um <strong>nome</strong>, que é uma pequena string de estilo "CamelCase" que identifica o erro ou condição anormal.</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="Properties">Properties</h2>
<dl>
<dt>{{domxref("DOMException.code")}} {{deprecated_inline}} {{readOnlyInline}}</dt>
<dd>Returns a <code>short</code> that contains one of the {{anch("Error codes", "error code constants")}}, or <code>0</code> if none match. This field is used for historical reasons. New DOM exceptions don't use this anymore: they put this info in the {{domxref("DOMException.name")}} attribute.</dd>
<dt>{{domxref("DOMException.message")}} {{readOnlyInline}}</dt>
<dd>Returns a {{ domxref("DOMString") }} representing a message or description associated with the given <a href="/en-US/docs/Web/API/DOMException#Error_names">error name</a>.</dd>
<dt>{{domxref("DOMException.name")}} {{readOnlyInline}}</dt>
<dd>Returns a {{domxref("DOMString")}} that contains one of the strings associated with an <a href="#Error_names">error name</a>.</dd>
</dl>
<h2 id="Error_names">Error names</h2>
<p>Common error names are listed here. Some APIs define their own sets of names, so this is not necessarily a complete list.</p>
<div class="note">
<p><strong>Note</strong>: Because historically the errors were identified by a numeric value which corresponded with a named variable defined to have that value, some of the entries below indicate the legacy code value and constant name that were used in the past.</p>
</div>
<dl>
<dt><a id="exception-IndexSizeError"><code>IndexSizeError</code></a></dt>
<dd>The index is not in the allowed range. For example, this can be thrown by the {{ domxref("Range") }} object. (Legacy code value: <code>1</code> and legacy constant name: <code>INDEX_SIZE_ERR</code>)</dd>
<dt><code><a id="exception-HierarchyRequestError">HierarchyRequestError</a></code></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><a id="exception-WrongDocumentError"><code>WrongDocumentError</code></a></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><a id="exception-InvalidCharacterError"><code>InvalidCharacterError</code></a></dt>
<dd>The string contains invalid characters. (Legacy code value: <code>5</code> and legacy constant name: <code>INVALID_CHARACTER_ERR</code>)</dd>
<dt><a id="exception-NoModificationAllowedError"><code>NoModificationAllowedError</code></a></dt>
<dd>The object cannot be modified. (Legacy code value: <code>7</code> and legacy constant name: <code>NO_MODIFICATION_ALLOWED_ERR</code>)</dd>
<dt><a id="exception-NotFoundError"><code>NotFoundError</code></a></dt>
<dd>The object cannot be found here. (Legacy code value: <code>8</code> and legacy constant name: <code>NOT_FOUND_ERR</code>)</dd>
<dt><a id="exception-NotFoundError"><code>NotSupportedError</code></a></dt>
<dd>The operation is not supported. (Legacy code value: <code>9</code> and legacy constant name: <code>NOT_SUPPORTED_ERR</code>)</dd>
<dt><a id="exception-InvalidStateError"><code>InvalidStateError</code></a></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><a id="exception-SyntaxError"><code>SyntaxError</code></a></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><a id="exception-InvalidModificationError"><code>InvalidModificationError</code></a></dt>
<dd>The object cannot be modified in this way. (Legacy code value: <code>13</code> and legacy constant name: <code>INVALID_MODIFICATION_ERR</code>)</dd>
<dt><a id="exception-NamespaceError"><code>NamespaceError</code></a></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><a id="exception-InvalidAccessError"><code>InvalidAccessError</code></a></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><a id="exception-TypeMismatchError"><code>TypeMismatchError</code></a> {{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><a id="exception-SecurityError"><code>SecurityError</code></a></dt>
<dd>The operation is insecure. (Legacy code value: <code>18</code> and legacy constant name: <code>SECURITY_ERR</code>)</dd>
<dt><a id="exception-NetworkError"><code>NetworkError</code></a> {{experimental_inline}}</dt>
<dd>A network error occurred. (Legacy code value: <code>19</code> and legacy constant name: <code>NETWORK_ERR</code>)</dd>
<dt><a id="exception-AbortError"><code>AbortError</code></a> {{experimental_inline}}</dt>
<dd>The operation was aborted. (Legacy code value: <code>20</code> and legacy constant name: <code>ABORT_ERR</code>)</dd>
<dt><a id="exception-URLMismatchError"><code>URLMismatchError</code></a> {{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><a id="exception-QuotaExceededError"><code>QuotaExceededError</code></a> {{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><a id="exception-TimeoutError"><code>TimeoutError</code></a></dt>
<dd>The operation timed out. (Legacy code value: <code>23</code> and legacy constant name: <code>TIMEOUT_ERR</code>)</dd>
<dt><a id="exception-InvalidNodeTypeError"><code>InvalidNodeTypeError</code></a> {{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><a id="exception-DataCloneError"><code>DataCloneError</code></a> {{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><a id="exception-EncodingError"><code>EncodingError</code></a> {{experimental_inline}}</dt>
<dd>The encoding or decoding operation failed (No legacy code value and constant name).</dd>
<dt><a id="exception-NotReadableError"><code>NotReadableError</code></a> {{experimental_inline}}</dt>
<dd>The input/output read operation failed (No legacy code value and constant name).</dd>
<dt><a id="exception-UnknownError"><code>UnknownError</code></a> {{experimental_inline}}</dt>
<dd>The operation failed for an unknown transient reason (e.g. out of memory) (No legacy code value and constant name).</dd>
<dt><a id="exception-ConstraintError"><code>ConstraintError</code></a> {{experimental_inline}}</dt>
<dd>A mutation operation in a transaction failed because a constraint was not satisfied (No legacy code value and constant name).</dd>
<dt><a id="exception-DataError"><code>DataError</code></a> {{experimental_inline}}</dt>
<dd>Provided data is inadequate (No legacy code value and constant name).</dd>
<dt><a id="exception-TransactionInactiveError"><code>TransactionInactiveError</code></a> {{experimental_inline}}</dt>
<dd>A request was placed against a transaction which is currently not active, or which is finished (No legacy code value and constant name).</dd>
<dt><a id="exception-ReadOnlyError"><code>ReadOnlyError</code></a> {{experimental_inline}}</dt>
<dd>The mutating operation was attempted in a "readonly" transaction (No legacy code value and constant name).</dd>
<dt><a id="exception-VersionError"><code>VersionError</code></a> {{experimental_inline}}</dt>
<dd>An attempt was made to open a database using a lower version than the existing version (No legacy code value and constant name).</dd>
<dt><a id="exception-OperationError"><code>OperationError</code></a> {{experimental_inline}}</dt>
<dd>The operation failed for an operation-specific reason (No legacy code value and constant name).</dd>
<dt><a id="exception-NotAllowedError"><code>NotAllowedError</code></a></dt>
<dd>The request is not allowed by the user agent or the platform in the current context, possibly because the user denied permission (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', '#idl-DOMException', 'constructor')}}</td>
<td>{{Spec2('WebIDL')}}</td>
<td>Adds the constructor for the <code>DOMException</code> class. Adds the <code>NotReadableError</code>, <code>UnknownError</code>, <code>ConstraintError</code>, <code>DataError</code>, <code>TransactionInactiveError</code>, <code>ReadOnlyError</code>, <code>VersionError</code>, <code>OperationError</code>, and <code>NotAllowedError</code> values.</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>{{Compat("api.DOMException")}}</p>
<h2 id="See_also">See also</h2>
<ul>
<li>{{ domxref("DOMError") }}</li>
</ul>
|
