W3C home > Mailing lists > Public > public-script-coord@w3.org > January to March 2012

Re: Numeric constants vs enumerated strings

From: Tab Atkins Jr. <jackalmage@gmail.com>
Date: Wed, 15 Feb 2012 11:51:47 -0800
Message-ID: <CAAWBYDDsgczVJsGOUs1iCBHb+O28C6zFcQcp01a8sK7fN_we4A@mail.gmail.com>
To: Dominique Hazael-Massieux <dom@w3.org>
Cc: Marcos Caceres <w3c@marcosc.com>, Anne van Kesteren <annevk@opera.com>, public-script-coord@w3.org, Harald Alvestrand <harald@alvestrand.no>, "public-webrtc@w3.org" <public-webrtc@w3.org>
On Wed, Feb 15, 2012 at 9:16 AM, Dominique Hazael-Massieux <dom@w3.org> wrote:
> (trimming cc as originally requested)
>
> Le mercredi 15 février 2012 à 17:05 +0000, Marcos Caceres a écrit :
>> > There are strong ties, in the sense that the said API would be exposing
>> > a readyState property (similar to XMLHttpRequest, HTMLMedia, etc).
>>
>> I'm not sure there is any relationship to the internal state of an
>> object and using object.SOME_HARD_TO_REMEMBER_AND_TYPE_THING…
>> specially when you can just type "thing".
>
> That's not the point; the point is that if we use strings for a
> readyState property in one API, and numeric values in many others, we
> would have scripts that have code that looks like:
>
> if (XHR.readyState == 4) {
>
> }
> if (P2P.readyState == "done") {
>
> }
>
> That seems utterly confusing, hard to remember, hard to teach, etc.

The old way is *so bad* that breaking with legacy practices is
justified.  I'm in favor of this as a general rule for all new APIs.

~TJ
Received on Wednesday, 15 February 2012 19:52:36 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 8 May 2013 19:30:05 UTC