зеркало из https://github.com/mozilla/gecko-dev.git
120 строки
3.8 KiB
Plaintext
120 строки
3.8 KiB
Plaintext
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#include "nsISupports.idl"
|
|
|
|
interface nsIDOMDOMRequest;
|
|
|
|
/**
|
|
* Represents a data interface for which the manager is recording statistics.
|
|
*/
|
|
[scriptable, uuid(f540615b-d803-43ff-8200-2a9d145a5645)]
|
|
interface nsIDOMMozNetworkStatsInterface : nsISupports
|
|
{
|
|
readonly attribute long type;
|
|
|
|
/**
|
|
* Id value is '0' for wifi or the iccid for mobile (SIM).
|
|
*/
|
|
readonly attribute DOMString id;
|
|
};
|
|
|
|
[scriptable, builtinclass, uuid(063ebeb2-5c6e-47ae-bdcd-5e6ebdc7a68c)]
|
|
interface nsIDOMMozNetworkStatsAlarm : nsISupports
|
|
{
|
|
readonly attribute unsigned long alarmId;
|
|
readonly attribute nsIDOMMozNetworkStatsInterface network;
|
|
readonly attribute long threshold;
|
|
readonly attribute jsval data;
|
|
};
|
|
|
|
[scriptable, uuid(8a66f4c1-0c25-4a66-9fc5-0106947b91f9)]
|
|
interface nsIDOMMozNetworkStatsManager : nsISupports
|
|
{
|
|
/**
|
|
* Constants for known interface types.
|
|
*/
|
|
const long WIFI = 0;
|
|
const long MOBILE = 1;
|
|
|
|
/**
|
|
* Find samples between two dates start and end, both included.
|
|
*
|
|
* If options is provided, per-app or per-system service usage will be
|
|
* retrieved; otherwise the target will be overall system usage.
|
|
*
|
|
* If success, the request result will be an nsIDOMMozNetworkStats object.
|
|
*/
|
|
nsIDOMDOMRequest getSamples(in nsIDOMMozNetworkStatsInterface network,
|
|
in jsval start,
|
|
in jsval end,
|
|
[optional] in jsval options /* NetworkStatsGetOptions */);
|
|
|
|
/**
|
|
* Install an alarm on a network. The network must be in the return of
|
|
* getAvailableNetworks() otherwise an "InvalidNetwork" exception will
|
|
* be raised.
|
|
*
|
|
* When total data usage reaches threshold bytes, a "networkstats-alarm"
|
|
* system message is sent to the application, where the optional parameter
|
|
* |data| must be a cloneable object.
|
|
*
|
|
* If success, the |result| field of the DOMRequest keeps the alarm Id.
|
|
*/
|
|
nsIDOMDOMRequest addAlarm(in nsIDOMMozNetworkStatsInterface network,
|
|
in long threshold,
|
|
[optional] in jsval options /* NetworkStatsAlarmOptions */);
|
|
|
|
/**
|
|
* Obtain all alarms for those networks returned by getAvailableNetworks().
|
|
* If a network is provided, only retrieves the alarms for that network.
|
|
* The network must be one of those returned by getAvailebleNetworks() or an
|
|
* "InvalidNetwork" exception will be raised.
|
|
*
|
|
* Each alarm object has the same fields as that in the system message:
|
|
* - alarmId
|
|
* - network
|
|
* - threshold
|
|
* - data
|
|
*/
|
|
nsIDOMDOMRequest getAllAlarms([optional] in nsIDOMMozNetworkStatsInterface network);
|
|
|
|
/**
|
|
* Remove all network alarms. If an |alarmId| is provided, then only that
|
|
* alarm is removed.
|
|
*/
|
|
nsIDOMDOMRequest removeAlarms([optional] in long alarmId);
|
|
|
|
/**
|
|
* Remove all stats related with the provided network from DB.
|
|
*/
|
|
nsIDOMDOMRequest clearStats(in nsIDOMMozNetworkStatsInterface network);
|
|
|
|
/**
|
|
* Remove all stats in the database.
|
|
*/
|
|
nsIDOMDOMRequest clearAllStats();
|
|
|
|
/**
|
|
* Return available networks that used to be saved in the database.
|
|
*/
|
|
nsIDOMDOMRequest getAvailableNetworks(); // array of nsIDOMMozNetworkStatsInterface.
|
|
|
|
/**
|
|
* Return available service types that used to be saved in the database.
|
|
*/
|
|
nsIDOMDOMRequest getAvailableServiceTypes(); // array of string.
|
|
|
|
/**
|
|
* Minimum time in milliseconds between samples stored in the database.
|
|
*/
|
|
readonly attribute long sampleRate;
|
|
|
|
/**
|
|
* Time in milliseconds recorded by the API until present time. All samples
|
|
* older than maxStorageAge from now are deleted.
|
|
*/
|
|
readonly attribute long long maxStorageAge;
|
|
};
|