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).

Синтаксис

js
getBattery()

Параметры

Отсутствуют.

Возвращаемое значение

Promise, который будет содержать объект BatteryManager.

Исключения

NotAllowedError DOMException (en-US)

Использование этой функциональности заблокировано Permissions Policy.

SecurityError DOMException (en-US)

Агент пользователя не предоставляет информацию о батарее в небезопасном контексте, и этот метод был вызван из такого контекста.

Примеры

В этом примере показано получение текущего состояния зарядки батареи и установка обработчика события chargingchange (en-US), чтобы можно было записать состояние, когда оно изменится.

js
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

Смотрите также