W3C home > Mailing lists > Public > public-device-apis@w3.org > September 2011

Re: [battery] Alternative design proposal (was: addEventListener side effects, ordering & boundary crossing ...)

From: Anssi Kostiainen <anssi.kostiainen@nokia.com>
Date: Wed, 14 Sep 2011 15:27:36 +0300
Cc: "public-device-apis@w3.org WG" <public-device-apis@w3.org>, ext Anne van Kesteren <annevk@opera.com>
Message-Id: <323580B5-0597-42C7-8C22-1F433F140388@nokia.com>
To: ext Dominique Hazael-Massieux <dom@w3.org>
Hi,

On 9.9.2011, at 9.46, ext Dominique Hazael-Massieux wrote:

> Le vendredi 09 septembre 2011 à 09:01 +0300, Anssi Kostiainen a écrit :
>> Here's a summary of discussed alternatives:
>> 
>> var b = new BatteryStatusEventSource();
>> b.onbatterystatus = function () {};
>> 
>> navigator.battery.start();
>> navigator.battery.onbatterystatus = function () {};
>> 
>> var b = navigator.getBattery();
>> b.onbatterystatus = function () {};
>> 
>> Which one is your favorite, and why?
> 
> I think the last one is probably my favorite, but mostly for cosmetic
> reason: it doesn't add a constructor (which for a singleton seems
> awkward), and it doesn't need the start() method (which reads weird: it
> feels like you're starting the battery itself).

I also do like the last one for the same reasons, but I have one concern in using it and that is the lack of consistency with other similar APIs hanging off of navigator, e.g.:

// both are asynchronous and return void
navigator.getUserMedia(options, success, error);
navigator.geolocation.getCurrentPosition(success, error, options);

Whereas the current design is similar to that of the EventSource.

I'm not sure how big a concern the lack of consistency would be here, given there are many differently behaving get*() methods out there on the web platform (both synchronous and asynchronous, with different order of parameters despite similar names etc.). 

Perhaps this is a non-issue?

-Anssi
Received on Wednesday, 14 September 2011 12:28:34 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:46:05 UTC