Navigator: метод getBattery()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Метод getBattery предоставляет информацию о батарее устройства. Он возвращает промис, результатом обработки которого будет объект BatteryManager, содержащий свойства с информацией о состоянии батареи и события, которые можно обрабатывать для его контроля. Для получения более подробной информации и примеров смотрите Battery Status API.
Примечание:
Доступ к этой функциональности контролируется директивой battery из Permissions-Policy.
Синтаксис
getBattery()
Параметры
Отсутствуют.
Возвращаемое значение
Promise, который будет содержать объект BatteryManager.
Исключения
NotAllowedErrorDOMException-
Использование этой функциональности заблокировано Permissions Policy.
SecurityErrorDOMException-
Агент пользователя не предоставляет информацию о батарее в небезопасном контексте, и этот метод был вызван из такого контекста.
Примеры
В этом примере показано получение текущего состояния зарядки батареи и установка обработчика события chargingchange, чтобы можно было записать состояние, когда оно изменится.
let batteryIsCharging = false;
navigator.getBattery().then((battery) => {
batteryIsCharging = battery.charging;
battery.addEventListener("chargingchange", () => {
batteryIsCharging = battery.charging;
});
});
Для подробностей и дополнительных примеров смотрите Battery Status API.
Спецификации
| Specification |
|---|
| Battery Status API # dom-navigator-getbattery |
Совместимость с браузерами
Loading…
Смотрите также
- Battery Status API
- Директива
batteryизPermissions-Policy