Navigator: метод getBattery()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/ru/web/api/battery_status_api/index.md)

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.

Синтаксис

js
getBattery()

Параметры

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

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

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

Исключения

NotAllowedError DOMException

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

SecurityError DOMException

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

Примеры

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

js
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

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