Navigator: метод getBattery()
Secure context: This feature is available only in secure contexts (en-US) (HTTPS), in some or all supporting browsers.
Метод getBattery
предоставляет информацию о батарее устройства. Он возвращает промис, результатом обработки которого будет объект BatteryManager
, содержащий свойства с информацией о состоянии батареи и события, которые можно обрабатывать для его контроля. Для получения более подробной информации и примеров смотрите Battery Status API
(en-US).
Примечание: Доступ к этой функциональности контролируется директивой battery
(en-US) из Permissions-Policy
(en-US).
Синтаксис
getBattery()
Параметры
Отсутствуют.
Возвращаемое значение
Promise
, который будет содержать объект BatteryManager
.
Исключения
NotAllowedError
DOMException
(en-US)-
Использование этой функциональности заблокировано Permissions Policy.
SecurityError
DOMException
(en-US)-
Агент пользователя не предоставляет информацию о батарее в небезопасном контексте, и этот метод был вызван из такого контекста.
Примеры
В этом примере показано получение текущего состояния зарядки батареи и установка обработчика события chargingchange
(en-US), чтобы можно было записать состояние, когда оно изменится.
let batteryIsCharging = false;
navigator.getBattery().then((battery) => {
batteryIsCharging = battery.charging;
battery.addEventListener("chargingchange", () => {
batteryIsCharging = battery.charging;
});
});
Для подробностей и дополнительных примеров смотрите Battery Status API
(en-US).
Спецификации
Specification |
---|
Battery Status API # dom-navigator-getbattery |
Совместимость с браузерами
BCD tables only load in the browser