Clarify 'If the implementation is unable to report' section;
authorAnssi Kostiainen <anssi.kostiainen@intel.com>
Tue, 01 Jul 2014 12:11:48 +0300
changeset 551 7067a05d6a79
parent 550 653cc635faca
child 552 10ea45927fa6
Clarify 'If the implementation is unable to report' section;
explain the rationale for the design.
battery/Overview.src.html
--- a/battery/Overview.src.html	Tue Jul 01 12:08:37 2014 +0300
+++ b/battery/Overview.src.html	Tue Jul 01 12:11:48 2014 +0300
@@ -189,12 +189,13 @@
       </p>
       <p>
         If the implementation is unable to report the battery status
-        information for a particular attribute, the <a>BatteryManager</a> will
-        emulate a fully charged battery by setting the attribute's value to a
-        value that of the fully charged battery. This prevents leaking of
-        information that could be used to fingerprint a user and allow web
-        developers to use the same code path for handling battery full and
-        battery status unknown cases.
+        information for any of the attributes, the <a>BatteryManager</a> will
+        emulate a fully charged battery by setting all the values to those
+        corresponding values of a fully charged battery. The reason for using
+        full battery defaults for unknown attribute values is that this will
+        not cause applications to degrade performance or functionality by
+        default if information is not available. It also reduces the potential
+        for fingerprinting.
       </p>
       <dl title="interface BatteryManager : EventTarget"
           class="idl">