@@ -5166,16 +5166,25 @@ The resulting behavior from creating and throwing an exception is language bindi
5166
5166
exception entails in the ECMAScript language binding.
5167
5167
5168
5168
5169
- <h4 id="idl-DOMException-error-names">{{DOMException}} error names</h4>
5169
+ <h4 id="idl-DOMException-error-names">Base {{DOMException}} error names</h4>
5170
5170
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.
5173
5174
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.
5177
5185
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.
5179
5188
5180
5189
Note: Don't confuse the "{{SyntaxError!!exception}}" {{DOMException}} defined here
5181
5190
with ECMAScript's {{ECMAScript/SyntaxError}}.
0 commit comments