25974 2014-06-04 09:07:05 +0000 DOMError removal language could be improved 2014-06-04 10:07:21 +0000 1 1 1 Unclassified WebAppsWG DOM unspecified PC Linux RESOLVED FIXED P2 normal --- 1 harald annevk mike www-dom public-webapps-bugzilla oldest_to_newest 107245 0 harald 2014-06-04 09:07:05 +0000 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. 107247 1 annevk 2014-06-04 09:15:58 +0000 Thanks Harald, how do you like: https://github.com/whatwg/dom/commit/3287ee475b41b8ee373affaab368422e500ef3c3 107252 2 harald 2014-06-04 09:53:47 +0000 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.) 107255 3 annevk 2014-06-04 10:07:21 +0000 Specifications are some weird alternate planet and implementations never quite seem to get there so we should be all safe.