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
.
Исключения
NotAllowedError
DOMException
-
Использование этой функциональности заблокировано Permissions Policy.
SecurityError
DOMException
-
Агент пользователя не предоставляет информацию о батарее в небезопасном контексте, и этот метод был вызван из такого контекста.
Примеры
В этом примере показано получение текущего состояния зарядки батареи и установка обработчика события 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 |
Совместимость с браузерами
BCD tables only load in the browser
Смотрите также
- Battery Status API
- Директива
battery
изPermissions-Policy