This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 25974 - DOMError removal language could be improved
Summary: DOMError removal language could be improved
Status: RESOLVED FIXED
Alias: None
Product: WebAppsWG
Classification: Unclassified
Component: DOM (show other bugs)
Version: unspecified
Hardware: PC Linux
: P2 normal
Target Milestone: ---
Assignee: Anne
QA Contact: public-webapps-bugzilla
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-06-04 09:07 UTC by Harald Alvestrand
Modified: 2014-06-04 10:07 UTC (History)
2 users (show)

See Also:


Attachments

Description Harald Alvestrand 2014-06-04 09:07:05 UTC
The current language concerning DOMError and DOMException says:

Warning: This entire section will move out of DOM into IDL. DOMException will be defined in terms of JavaScript and made available in both document and worker environments. DOMError will be phased out.
.....
Warning: DOMError is defined here but only used in other specifications. DOMError will be phased out in favor of using DOMException exclusively. See Creating your own errors on es-discuss for more details.

This language does not, I believe, give clear advice on how to deal with DOMError. A suggested rewording:

Warning: In the future, DOMException will be defined as a synonym for some yet-unnamed construct in the Javascript specification. The definition given here may be referenced until such a time as this construct is available.
....
Warning: New specifications should not inherit from or use DOMError in their specifications. This definition is only preserved in this document to make a stable reference for specifications that inherit from or use DOMError today.
Once all those specifications are updated to not use DOMError, the definition of DOMError will be removed from future versions of this document.
Comment 1 Anne 2014-06-04 09:15:58 UTC
Thanks Harald, how do you like: https://github.com/whatwg/dom/commit/3287ee475b41b8ee373affaab368422e500ef3c3
Comment 2 Harald Alvestrand 2014-06-04 09:53:47 UTC
I don't like the phrase "nuked from orbit", because that's one of the things I prefer to happen on other planets than my own - and it's hard to map the florid prose into a real picture of what is intended to happen and when.

I'd prefer "will be removed when the specs that reference it are updated" or "will be removed when the specs that reference it are irrelevant" (the latter might happen before the former).

(Of course, if WHATWG is considered a different planet, that helps a bit.)
Comment 3 Anne 2014-06-04 10:07:21 UTC
Specifications are some weird alternate planet and implementations never quite seem to get there so we should be all safe.