WebAPI/NetworkAPI: Difference between revisions

WebAPI/NetworkAPI (view source)

309 bytes added , 29 December 2011

→‎Notes: updated and clearer

Confirmed users

368

edits

@@ Line 30: / Line 30: @@
 == Notes ==
-* .speed will be some arbitrary values for the moment. It might be really estimated later.
+* .bandwidth should be an estimated value of the download speed. That could be based on pure empirical observations (like 3G is usually around 300kB/s) or very precise value. However, this is an implementation detail and the consumer of this API shouldn't care about how the estimation is made.
-* .restricted is going to return false unless a pref is switched by the user. In that case, it will return true if the connection is of a mobile type (like 2/3/4g).
+* .metered reflects whether the current connection bandwidth is metered in the sense of there is a pay-per-use policy or a periodic quota. This is typical for 2G and 3G connections. Firefox will implement this by asking the user.
-* There is no .type because we believe that might be abused. It could be added later if there is a strong need for it.
+* There is no .type because we believe that might be abused: it is error-prone and not future-proof. It could be added later if there is a strong need for it.
 == Considered changes ==