MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

BatteryManager

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Интерфейс BatteryManager предоставляет пути получения информации о уровне заряда батареи устройства.

Метод navigator.getBattery() возвращает battery promise, разрешающий использование BatteryManager интерфейса, который вы можете использовать для взаимодействия с Battery Status API.

Свойства

BatteryManager.charging Только для чтения
Значение с булевым типом, заряжается сейчас батарея или нет.
BatteryManager.chargingTime Только для чтения
Число оставшихся секунд до полной зарядки, или 0, если устройство заряжено.
BatteryManager.dischargingTime Только для чтения
Число оставшихся секунд до полной разрядки устройства.
BatteryManager.level Только для чтения
Число между 0.0 и 1.0, показывающее уровень заряда батареи устройства.

Обработчики событий

BatteryManager.onchargingchange
Обработчик для chargingchange события; Событие вызывается при обновлении состояния процесса зарядки батареи на текущий момент.
BatteryManager.onchargingtimechange
Обработчик для chargingtimechange события; Событие вызывается при обнавлении времени до полной зарядки батареи устройства.
BatteryManager.ondischargingtimechange
Обработчик для dischargingtimechange события; Событие вызывается при обновлении времени до разрядки батареи устройства.
BatteryManager.onlevelchange
Обработчик для levelchange события; Событие вызывается при обновление уровня заряда батареи устройства.

Методы

Наследует от EventTarget:

EventTarget.addEventListener()
Регистрирует обработчик событий указанного типа на объекте.
EventTarget.removeEventListener()
Удаляет обработчик события.
EventTarget.dispatchEvent()
Генерирует событие на объекте EventTarget.

Спецификация

Спецификация Статус Комментарий
Battery Status API Кандидат в рекомендации Исходное определение

Браузерная совместимость

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка 39.0 10 (10) moz
16 (16)[1]
52 (52)[3]
Нет 25 Нет
Feature Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Базовая поддержка Нет 40.0 10.0 (10) moz
16.0 (16)[1]
52.0 (52)[3]
Нет 25[2] Нет 42.0[2]

[1] Отключено по стандарту в Firefox 10.0, но можно включить установкой свойству dom.battery.enabled значения true. Начиная с Firefox 11.0, mozBattery включено по умолчанию. Battery API поддерживается на Android, Windows, и Linux с установленным UPower. Поддержка для MacOS доступна начиная с Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox также предоставляет поддержку для устаревшего navigator.battery.

[2] Значения для BatteryManager.chargingTime и BatteryManager.dischargingTime всегда равны Infinity.

[3] Начиная с Firefox 52 и далее, Battery Status API доступен только в chrome/привелигированном коде.

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

Метки документа и участники

 Внесли вклад в эту страницу: nikitaermishin
 Обновлялась последний раз: nikitaermishin,