Skip to content

Commit

Permalink
[e] (0) tweak the way we talk about exceptions
Browse files Browse the repository at this point in the history 
git-svn-id: http://svn.whatwg.org/webapps@6320 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Jul 22, 2011
1 parent 0e864b7 commit 3e159fc
Show file tree
Hide file tree
Showing 3 changed files with 145 additions and 111 deletions.
85 changes: 48 additions & 37 deletions complete.html
View file
Expand Up @@ -382,8 +382,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
<li><a href=#transferable-objects><span class=secno>2.8.7 </span>Transferable objects</a></li>
<li><a href=#safe-passing-of-structured-data><span class=secno>2.8.8 </span>Safe passing of structured data</a></li>
<li><a href=#dom-feature-strings><span class=secno>2.8.9 </span>DOM feature strings</a></li>
<li><a href=#exceptions><span class=secno>2.8.10 </span>Exceptions</a></li>
<li><a href=#garbage-collection><span class=secno>2.8.11 </span>Garbage collection</a></ol></li>
<li><a href=#garbage-collection><span class=secno>2.8.10 </span>Garbage collection</a></ol></li>
<li><a href=#namespaces><span class=secno>2.9 </span>Namespaces</a></ol></li>
<li><a href=#dom><span class=secno>3 </span>Semantics, structure, and APIs of HTML documents</a>
<ol>
Expand Down Expand Up @@ -3541,7 +3540,51 @@ <h4 id=dependencies><span class=secno>2.2.2 </span>Dependencies</h4>

<li><dfn id=dom-event-target title=dom-Event-target><code>target</code></dfn> attribute</li>

</ul><p>The following features are defined in the DOM Events
</ul><p>The following <code><a href=#domexception>DOMException</a></code> codes are defined in
the DOM Core specification: <a href=#refsDOMCORE>[DOMCORE]</a></p>

<ol class=brief><li value=1><dfn id=index_size_err><code>INDEX_SIZE_ERR</code></dfn></li>
<li value=2><dfn id=domstring_size_err><code>DOMSTRING_SIZE_ERR</code></dfn></li>
<li value=3><dfn id=hierarchy_request_err><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
<li value=4><dfn id=wrong_document_err><code>WRONG_DOCUMENT_ERR</code></dfn></li>
<li value=5><dfn id=invalid_character_err><code>INVALID_CHARACTER_ERR</code></dfn></li>
<li value=6><dfn id=no_data_allowed_err><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
<li value=7><dfn id=no_modification_allowed_err><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
<li value=8><dfn id=not_found_err><code>NOT_FOUND_ERR</code></dfn></li>
<li value=9><dfn id=not_supported_err><code>NOT_SUPPORTED_ERR</code></dfn></li>
<li value=10><dfn id=inuse_attribute_err><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
<li value=11><dfn id=invalid_state_err><code>INVALID_STATE_ERR</code></dfn></li>
<li value=12><dfn id=syntax_err><code>SYNTAX_ERR</code></dfn></li>
<li value=13><dfn id=invalid_modification_err><code>INVALID_MODIFICATION_ERR</code></dfn></li>
<li value=14><dfn id=namespace_err><code>NAMESPACE_ERR</code></dfn></li>
<li value=15><dfn id=invalid_access_err><code>INVALID_ACCESS_ERR</code></dfn></li>
<li value=16><dfn id=validation_err><code>VALIDATION_ERR</code></dfn></li>
<li value=17><dfn id=type_mismatch_err><code>TYPE_MISMATCH_ERR</code></dfn></li>
<li value=18><dfn id=security_err><code>SECURITY_ERR</code></dfn></li>
<li value=19><dfn id=network_err><code>NETWORK_ERR</code></dfn></li>
<li value=20><dfn id=abort_err><code>ABORT_ERR</code></dfn></li>
<li value=21><dfn id=url_mismatch_err><code>URL_MISMATCH_ERR</code></dfn></li>
<li value=22><dfn id=quota_exceeded_err><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
<li value=23><dfn id=timeout_err><code>TIMEOUT_ERR</code></dfn></li>
<li value=24><dfn id=invalid_node_type_err><code>INVALID_NODE_TYPE_ERR</code></dfn></li>
<li value=25><dfn id=data_clone_err><code>DATA_CLONE_ERR</code></dfn></li>
<!--
<li value="81"><dfn><code>PARSE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
<li value="82"><dfn><code>SERIALIZE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
-->
</ol><p>When this specification requires that a user agent <i>throw</i>
or <i>raise</i> an exception named using a code listed above, it
means that the user agent is required to create a
<code><a href=#domexception>DOMException</a></code> exception object configured to represent
the condition with the given code, then handle that object as a
thrown exception as defined in the JavaScript specification. <a href=#refsECMA262>[ECMA262]</a></p>

<p class=example>For example, to <i>throw a
<code><a href=#timeout_err>TIMEOUT_ERR</a></code> exception</i>, a user agent would
construct a <code><a href=#domexception>DOMException</a></code> object whose code was set to
23 and actually throw that object as an exception.</p>

<p>The following features are defined in the DOM Events
specification: <a href=#refsDOMEVENTS>[DOMEVENTS]</a></p>

<ul class=brief><li><dfn id=uievent><code>UIEvent</code></dfn> interface</li>
Expand Down Expand Up @@ -9008,41 +9051,9 @@ <h4 id=dom-feature-strings><span class=secno>2.8.9 </span>DOM feature strings</h
</div>


<h4 id=exceptions><span class=secno>2.8.10 </span>Exceptions</h4>

<p>The following are <code><a href=#domexception>DOMException</a></code> codes. <a href=#refsDOMCORE>[DOMCORE]</a></p>

<ol class=brief><li value=1><dfn id=index_size_err><code>INDEX_SIZE_ERR</code></dfn></li>
<li value=2><dfn id=domstring_size_err><code>DOMSTRING_SIZE_ERR</code></dfn></li>
<li value=3><dfn id=hierarchy_request_err><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
<li value=4><dfn id=wrong_document_err><code>WRONG_DOCUMENT_ERR</code></dfn></li>
<li value=5><dfn id=invalid_character_err><code>INVALID_CHARACTER_ERR</code></dfn></li>
<li value=6><dfn id=no_data_allowed_err><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
<li value=7><dfn id=no_modification_allowed_err><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
<li value=8><dfn id=not_found_err><code>NOT_FOUND_ERR</code></dfn></li>
<li value=9><dfn id=not_supported_err><code>NOT_SUPPORTED_ERR</code></dfn></li>
<li value=10><dfn id=inuse_attribute_err><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
<li value=11><dfn id=invalid_state_err><code>INVALID_STATE_ERR</code></dfn></li>
<li value=12><dfn id=syntax_err><code>SYNTAX_ERR</code></dfn></li>
<li value=13><dfn id=invalid_modification_err><code>INVALID_MODIFICATION_ERR</code></dfn></li>
<li value=14><dfn id=namespace_err><code>NAMESPACE_ERR</code></dfn></li>
<li value=15><dfn id=invalid_access_err><code>INVALID_ACCESS_ERR</code></dfn></li>
<li value=16><dfn id=validation_err><code>VALIDATION_ERR</code></dfn></li>
<li value=17><dfn id=type_mismatch_err><code>TYPE_MISMATCH_ERR</code></dfn></li>
<li value=18><dfn id=security_err><code>SECURITY_ERR</code></dfn></li>
<li value=19><dfn id=network_err><code>NETWORK_ERR</code></dfn></li>
<li value=20><dfn id=abort_err><code>ABORT_ERR</code></dfn></li>
<li value=21><dfn id=url_mismatch_err><code>URL_MISMATCH_ERR</code></dfn></li>
<li value=22><dfn id=quota_exceeded_err><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
<li value=23><dfn id=timeout_err><code>TIMEOUT_ERR</code></dfn></li>
<li value=25><dfn id=data_clone_err><code>DATA_CLONE_ERR</code></dfn></li>
<!--
<li value="81"><dfn><code>PARSE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
<li value="82"><dfn><code>SERIALIZE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
-->
</ol><div class=impl>
<div class=impl>

<h4 id=garbage-collection><span class=secno>2.8.11 </span>Garbage collection</h4>
<h4 id=garbage-collection><span class=secno>2.8.10 </span>Garbage collection</h4>

<p>There is an <dfn id=implied-strong-reference>implied strong reference</dfn> from any IDL
attribute that returns a pre-existing object to that object.</p>
Expand Down
85 changes: 48 additions & 37 deletions index
View file
Expand Up @@ -382,8 +382,7 @@
<li><a href=#transferable-objects><span class=secno>2.8.7 </span>Transferable objects</a></li>
<li><a href=#safe-passing-of-structured-data><span class=secno>2.8.8 </span>Safe passing of structured data</a></li>
<li><a href=#dom-feature-strings><span class=secno>2.8.9 </span>DOM feature strings</a></li>
<li><a href=#exceptions><span class=secno>2.8.10 </span>Exceptions</a></li>
<li><a href=#garbage-collection><span class=secno>2.8.11 </span>Garbage collection</a></ol></li>
<li><a href=#garbage-collection><span class=secno>2.8.10 </span>Garbage collection</a></ol></li>
<li><a href=#namespaces><span class=secno>2.9 </span>Namespaces</a></ol></li>
<li><a href=#dom><span class=secno>3 </span>Semantics, structure, and APIs of HTML documents</a>
<ol>
Expand Down Expand Up @@ -3443,7 +3442,51 @@ explained in the previous section, which talks about RFC 2119. -->

<li><dfn id=dom-event-target title=dom-Event-target><code>target</code></dfn> attribute</li>

</ul><p>The following features are defined in the DOM Events
</ul><p>The following <code><a href=#domexception>DOMException</a></code> codes are defined in
the DOM Core specification: <a href=#refsDOMCORE>[DOMCORE]</a></p>

<ol class=brief><li value=1><dfn id=index_size_err><code>INDEX_SIZE_ERR</code></dfn></li>
<li value=2><dfn id=domstring_size_err><code>DOMSTRING_SIZE_ERR</code></dfn></li>
<li value=3><dfn id=hierarchy_request_err><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
<li value=4><dfn id=wrong_document_err><code>WRONG_DOCUMENT_ERR</code></dfn></li>
<li value=5><dfn id=invalid_character_err><code>INVALID_CHARACTER_ERR</code></dfn></li>
<li value=6><dfn id=no_data_allowed_err><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
<li value=7><dfn id=no_modification_allowed_err><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
<li value=8><dfn id=not_found_err><code>NOT_FOUND_ERR</code></dfn></li>
<li value=9><dfn id=not_supported_err><code>NOT_SUPPORTED_ERR</code></dfn></li>
<li value=10><dfn id=inuse_attribute_err><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
<li value=11><dfn id=invalid_state_err><code>INVALID_STATE_ERR</code></dfn></li>
<li value=12><dfn id=syntax_err><code>SYNTAX_ERR</code></dfn></li>
<li value=13><dfn id=invalid_modification_err><code>INVALID_MODIFICATION_ERR</code></dfn></li>
<li value=14><dfn id=namespace_err><code>NAMESPACE_ERR</code></dfn></li>
<li value=15><dfn id=invalid_access_err><code>INVALID_ACCESS_ERR</code></dfn></li>
<li value=16><dfn id=validation_err><code>VALIDATION_ERR</code></dfn></li>
<li value=17><dfn id=type_mismatch_err><code>TYPE_MISMATCH_ERR</code></dfn></li>
<li value=18><dfn id=security_err><code>SECURITY_ERR</code></dfn></li>
<li value=19><dfn id=network_err><code>NETWORK_ERR</code></dfn></li>
<li value=20><dfn id=abort_err><code>ABORT_ERR</code></dfn></li>
<li value=21><dfn id=url_mismatch_err><code>URL_MISMATCH_ERR</code></dfn></li>
<li value=22><dfn id=quota_exceeded_err><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
<li value=23><dfn id=timeout_err><code>TIMEOUT_ERR</code></dfn></li>
<li value=24><dfn id=invalid_node_type_err><code>INVALID_NODE_TYPE_ERR</code></dfn></li>
<li value=25><dfn id=data_clone_err><code>DATA_CLONE_ERR</code></dfn></li>
<!--
<li value="81"><dfn><code>PARSE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
<li value="82"><dfn><code>SERIALIZE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
-->
</ol><p>When this specification requires that a user agent <i>throw</i>
or <i>raise</i> an exception named using a code listed above, it
means that the user agent is required to create a
<code><a href=#domexception>DOMException</a></code> exception object configured to represent
the condition with the given code, then handle that object as a
thrown exception as defined in the JavaScript specification. <a href=#refsECMA262>[ECMA262]</a></p>

<p class=example>For example, to <i>throw a
<code><a href=#timeout_err>TIMEOUT_ERR</a></code> exception</i>, a user agent would
construct a <code><a href=#domexception>DOMException</a></code> object whose code was set to
23 and actually throw that object as an exception.</p>

<p>The following features are defined in the DOM Events
specification: <a href=#refsDOMEVENTS>[DOMEVENTS]</a></p>

<ul class=brief><li><dfn id=uievent><code>UIEvent</code></dfn> interface</li>
Expand Down Expand Up @@ -8877,41 +8920,9 @@ interface <dfn id=transferable>Transferable</dfn> { };</pre>
</div>


<h4 id=exceptions><span class=secno>2.8.10 </span>Exceptions</h4>

<p>The following are <code><a href=#domexception>DOMException</a></code> codes. <a href=#refsDOMCORE>[DOMCORE]</a></p>

<ol class=brief><li value=1><dfn id=index_size_err><code>INDEX_SIZE_ERR</code></dfn></li>
<li value=2><dfn id=domstring_size_err><code>DOMSTRING_SIZE_ERR</code></dfn></li>
<li value=3><dfn id=hierarchy_request_err><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
<li value=4><dfn id=wrong_document_err><code>WRONG_DOCUMENT_ERR</code></dfn></li>
<li value=5><dfn id=invalid_character_err><code>INVALID_CHARACTER_ERR</code></dfn></li>
<li value=6><dfn id=no_data_allowed_err><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
<li value=7><dfn id=no_modification_allowed_err><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
<li value=8><dfn id=not_found_err><code>NOT_FOUND_ERR</code></dfn></li>
<li value=9><dfn id=not_supported_err><code>NOT_SUPPORTED_ERR</code></dfn></li>
<li value=10><dfn id=inuse_attribute_err><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
<li value=11><dfn id=invalid_state_err><code>INVALID_STATE_ERR</code></dfn></li>
<li value=12><dfn id=syntax_err><code>SYNTAX_ERR</code></dfn></li>
<li value=13><dfn id=invalid_modification_err><code>INVALID_MODIFICATION_ERR</code></dfn></li>
<li value=14><dfn id=namespace_err><code>NAMESPACE_ERR</code></dfn></li>
<li value=15><dfn id=invalid_access_err><code>INVALID_ACCESS_ERR</code></dfn></li>
<li value=16><dfn id=validation_err><code>VALIDATION_ERR</code></dfn></li>
<li value=17><dfn id=type_mismatch_err><code>TYPE_MISMATCH_ERR</code></dfn></li>
<li value=18><dfn id=security_err><code>SECURITY_ERR</code></dfn></li>
<li value=19><dfn id=network_err><code>NETWORK_ERR</code></dfn></li>
<li value=20><dfn id=abort_err><code>ABORT_ERR</code></dfn></li>
<li value=21><dfn id=url_mismatch_err><code>URL_MISMATCH_ERR</code></dfn></li>
<li value=22><dfn id=quota_exceeded_err><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
<li value=23><dfn id=timeout_err><code>TIMEOUT_ERR</code></dfn></li>
<li value=25><dfn id=data_clone_err><code>DATA_CLONE_ERR</code></dfn></li>
<!--
<li value="81"><dfn><code>PARSE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
<li value="82"><dfn><code>SERIALIZE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
-->
</ol><div class=impl>
<div class=impl>

<h4 id=garbage-collection><span class=secno>2.8.11 </span>Garbage collection</h4>
<h4 id=garbage-collection><span class=secno>2.8.10 </span>Garbage collection</h4>

<p>There is an <dfn id=implied-strong-reference>implied strong reference</dfn> from any IDL
attribute that returns a pre-existing object to that object.</p>
Expand Down
86 changes: 49 additions & 37 deletions source
View file
Expand Up @@ -2437,6 +2437,55 @@ explained in the previous section, which talks about RFC 2119. -->

</ul>

<p>The following <code>DOMException</code> codes are defined in
the DOM Core specification: <a
href="#refsDOMCORE">[DOMCORE]</a></p>

<ol class="brief">
<li value="1"><dfn><code>INDEX_SIZE_ERR</code></dfn></li>
<li value="2"><dfn><code>DOMSTRING_SIZE_ERR</code></dfn></li>
<li value="3"><dfn><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
<li value="4"><dfn><code>WRONG_DOCUMENT_ERR</code></dfn></li>
<li value="5"><dfn><code>INVALID_CHARACTER_ERR</code></dfn></li>
<li value="6"><dfn><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
<li value="7"><dfn><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
<li value="8"><dfn><code>NOT_FOUND_ERR</code></dfn></li>
<li value="9"><dfn><code>NOT_SUPPORTED_ERR</code></dfn></li>
<li value="10"><dfn><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
<li value="11"><dfn><code>INVALID_STATE_ERR</code></dfn></li>
<li value="12"><dfn><code>SYNTAX_ERR</code></dfn></li>
<li value="13"><dfn><code>INVALID_MODIFICATION_ERR</code></dfn></li>
<li value="14"><dfn><code>NAMESPACE_ERR</code></dfn></li>
<li value="15"><dfn><code>INVALID_ACCESS_ERR</code></dfn></li>
<li value="16"><dfn><code>VALIDATION_ERR</code></dfn></li>
<li value="17"><dfn><code>TYPE_MISMATCH_ERR</code></dfn></li>
<li value="18"><dfn><code>SECURITY_ERR</code></dfn></li>
<li value="19"><dfn><code>NETWORK_ERR</code></dfn></li>
<li value="20"><dfn><code>ABORT_ERR</code></dfn></li>
<li value="21"><dfn><code>URL_MISMATCH_ERR</code></dfn></li>
<li value="22"><dfn><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
<li value="23"><dfn><code>TIMEOUT_ERR</code></dfn></li>
<li value="24"><dfn><code>INVALID_NODE_TYPE_ERR</code></dfn></li>
<li value="25"><dfn><code>DATA_CLONE_ERR</code></dfn></li>
<!--
<li value="81"><dfn><code>PARSE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
<li value="82"><dfn><code>SERIALIZE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
-->
</ol>

<p>When this specification requires that a user agent <i>throw</i>
or <i>raise</i> an exception named using a code listed above, it
means that the user agent is required to create a
<code>DOMException</code> exception object configured to represent
the condition with the given code, then handle that object as a
thrown exception as defined in the JavaScript specification. <a
href="#refsECMA262">[ECMA262]</a></p>

<p class="example">For example, to <i>throw a
<code>TIMEOUT_ERR</code> exception</i>, a user agent would
construct a <code>DOMException</code> object whose code was set to
23 and actually throw that object as an exception.</p>

<p>The following features are defined in the DOM Events
specification: <a href="#refsDOMEVENTS">[DOMEVENTS]</a></p>

Expand Down Expand Up @@ -9025,43 +9074,6 @@ interface <dfn>Transferable</dfn> { };</pre>
</div>


<h4>Exceptions</h4>

<p>The following are <code>DOMException</code> codes. <a
href="#refsDOMCORE">[DOMCORE]</a></p>

<ol class="brief">
<li value="1"><dfn><code>INDEX_SIZE_ERR</code></dfn></li>
<li value="2"><dfn><code>DOMSTRING_SIZE_ERR</code></dfn></li>
<li value="3"><dfn><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
<li value="4"><dfn><code>WRONG_DOCUMENT_ERR</code></dfn></li>
<li value="5"><dfn><code>INVALID_CHARACTER_ERR</code></dfn></li>
<li value="6"><dfn><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
<li value="7"><dfn><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
<li value="8"><dfn><code>NOT_FOUND_ERR</code></dfn></li>
<li value="9"><dfn><code>NOT_SUPPORTED_ERR</code></dfn></li>
<li value="10"><dfn><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
<li value="11"><dfn><code>INVALID_STATE_ERR</code></dfn></li>
<li value="12"><dfn><code>SYNTAX_ERR</code></dfn></li>
<li value="13"><dfn><code>INVALID_MODIFICATION_ERR</code></dfn></li>
<li value="14"><dfn><code>NAMESPACE_ERR</code></dfn></li>
<li value="15"><dfn><code>INVALID_ACCESS_ERR</code></dfn></li>
<li value="16"><dfn><code>VALIDATION_ERR</code></dfn></li>
<li value="17"><dfn><code>TYPE_MISMATCH_ERR</code></dfn></li>
<li value="18"><dfn><code>SECURITY_ERR</code></dfn></li>
<li value="19"><dfn><code>NETWORK_ERR</code></dfn></li>
<li value="20"><dfn><code>ABORT_ERR</code></dfn></li>
<li value="21"><dfn><code>URL_MISMATCH_ERR</code></dfn></li>
<li value="22"><dfn><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
<li value="23"><dfn><code>TIMEOUT_ERR</code></dfn></li>
<li value="25"><dfn><code>DATA_CLONE_ERR</code></dfn></li>
<!--
<li value="81"><dfn><code>PARSE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
<li value="82"><dfn><code>SERIALIZE_ERR</code></dfn></li> <!- - actually defined in dom3ls - ->
-->
</ol>


<div class="impl">

<h4>Garbage collection</h4>
Expand Down

0 comments on commit 3e159fc

Please sign in to comment.