Skip to content

Commit 936dfd4

Browse files
committed
Be clearer about error names table, but see issue 1219
1 parent 6eaf13e commit 936dfd4

File tree

1 file changed

+16
-7
lines changed

1 file changed

+16
-7
lines changed

index.bs

+16-7
Original file line numberDiff line numberDiff line change
@@ -5166,16 +5166,25 @@ The resulting behavior from creating and throwing an exception is language bindi
51665166
exception entails in the ECMAScript language binding.
51675167

51685168

5169-
<h4 id="idl-DOMException-error-names">{{DOMException}} error names</h4>
5169+
<h4 id="idl-DOMException-error-names">Base {{DOMException}} error names</h4>
51705170

5171-
The <dfn id="dfn-error-names-table" export>error names table</dfn> below lists all the allowed error names
5172-
for {{DOMException}}, a description, and legacy code values.
5171+
The <dfn id="dfn-error-names-table" export>error names table</dfn> below lists all the allowed error
5172+
names for instances of the base {{DOMException}} interface, along with a description of what such
5173+
error names mean, and legacy numeric error code values.
51735174

5174-
<p class="warning">
5175-
The {{DOMException}} names marked as deprecated are kept for legacy purposes but their usage is discouraged.
5176-
</p>
5175+
<p class="note">Interfaces [=interface/inheriting=] from {{DOMException}}, in the manner described
5176+
in [[#idl-DOMException-derived-interfaces]], will have their own names, not listed in this table.
5177+
5178+
When [=exception/creating=] or [=exception/throwing=] a {{DOMException}}, specifications must use
5179+
one of these names. If a specification author believes none of these names are a good fit for their
5180+
case, they must
5181+
<a href="https://github.com/heycam/webidl/issues/new?title=DOMException%20name%20proposal">file an issue</a>
5182+
to discuss adding a new name to the shared namespace, so that the community can coordinate such
5183+
efforts. Note that adding new use-case-specific names is only important if you believe web
5184+
developers will discriminate multiple error conditions arising from a single API.
51775185

5178-
Note: If an error name is not listed here, please file a bug as indicated at the top of this specification and it will be addressed shortly. Thanks!
5186+
<p class="warning">The {{DOMException}} names marked as deprecated are kept for legacy purposes, but
5187+
their usage is discouraged.
51795188

51805189
Note: Don't confuse the "{{SyntaxError!!exception}}" {{DOMException}} defined here
51815190
with ECMAScript's {{ECMAScript/SyntaxError}}.

0 commit comments

Comments
 (0)