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 Кандидат в рекомендации Исходное определение

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
BatteryManager
Устаревшая
Chrome Полная поддержка 38Edge Полная поддержка 79Firefox Нет поддержки 16 — 52
Нет поддержки 16 — 52
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Полная поддержка 52
Замечания Отключено
Замечания Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery.
Отключено From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Полная поддержка 72
Замечания
Замечания From this version onwards, BatteryManager is only available in chrome/privileged code.
IE Нет поддержки НетOpera Полная поддержка 25Safari Нет поддержки НетWebView Android Полная поддержка 40Chrome Android Полная поддержка 38
Замечания
Полная поддержка 38
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
Firefox Android Нет поддержки 10 — 16
С префиксом
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Нет поддержки 16 — 52
Замечания Отключено
Замечания Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery.
Отключено From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android Полная поддержка 25Safari iOS Нет поддержки ? — ?Samsung Internet Android Полная поддержка 3.0
Замечания
Полная поддержка 3.0
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
charging
Устаревшая
Chrome Полная поддержка 38Edge Полная поддержка 79Firefox Нет поддержки 16 — 52
Нет поддержки 16 — 52
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Полная поддержка 52
Замечания Отключено
Замечания Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery.
Отключено From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Полная поддержка 72
Замечания
Замечания From this version onwards, BatteryManager is only available in chrome/privileged code.
IE Нет поддержки НетOpera Полная поддержка 25Safari Нет поддержки НетWebView Android Полная поддержка 40Chrome Android Полная поддержка 38
Замечания
Полная поддержка 38
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
Firefox Android Нет поддержки 10 — 16
С префиксом
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Нет поддержки 16 — 52
Замечания Отключено
Замечания Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery.
Отключено From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android Полная поддержка 25Safari iOS Нет поддержки ? — ?Samsung Internet Android Полная поддержка 3.0
Замечания
Полная поддержка 3.0
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
chargingTime
Устаревшая
Chrome Полная поддержка 38Edge Полная поддержка 79Firefox Нет поддержки 16 — 52
Нет поддержки 16 — 52
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Полная поддержка 52
Замечания Отключено
Замечания Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery.
Отключено From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Полная поддержка 72
Замечания
Замечания From this version onwards, BatteryManager is only available in chrome/privileged code.
IE Нет поддержки НетOpera Полная поддержка 25Safari Нет поддержки НетWebView Android Полная поддержка 40Chrome Android Полная поддержка 38
Замечания
Полная поддержка 38
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
Firefox Android Нет поддержки 10 — 16
С префиксом
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Нет поддержки 16 — 52
Замечания Отключено
Замечания Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery.
Отключено From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android Полная поддержка 25Safari iOS Нет поддержки ? — ?Samsung Internet Android Полная поддержка 3.0
Замечания
Полная поддержка 3.0
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
dischargingTime
Устаревшая
Chrome Полная поддержка 38Edge Полная поддержка 79Firefox Нет поддержки 16 — 52
Нет поддержки 16 — 52
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Полная поддержка 52
Замечания Отключено
Замечания Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery.
Отключено From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Полная поддержка 72
Замечания
Замечания From this version onwards, BatteryManager is only available in chrome/privileged code.
IE Нет поддержки НетOpera Полная поддержка 25Safari Нет поддержки НетWebView Android Полная поддержка 40Chrome Android Полная поддержка 38
Замечания
Полная поддержка 38
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
Firefox Android Нет поддержки 10 — 16
С префиксом
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Нет поддержки 16 — 52
Замечания Отключено
Замечания Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery.
Отключено From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android Полная поддержка 25Safari iOS Нет поддержки ? — ?Samsung Internet Android Полная поддержка 3.0
Замечания
Полная поддержка 3.0
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
level
Устаревшая
Chrome Полная поддержка 38Edge Полная поддержка 79Firefox Нет поддержки 16 — 52
Нет поддержки 16 — 52
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Полная поддержка 52
Замечания Отключено
Замечания Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery.
Отключено From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Полная поддержка 72
Замечания
Замечания From this version onwards, BatteryManager is only available in chrome/privileged code.
IE Нет поддержки НетOpera Полная поддержка 25Safari Нет поддержки НетWebView Android Полная поддержка 40Chrome Android Полная поддержка 38
Замечания
Полная поддержка 38
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
Firefox Android Нет поддержки 10 — 16
С префиксом
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Нет поддержки 16 — 52
Замечания Отключено
Замечания Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery.
Отключено From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android Полная поддержка 25Safari iOS Нет поддержки ? — ?Samsung Internet Android Полная поддержка 3.0
Замечания
Полная поддержка 3.0
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
onchargingchange
Устаревшая
Chrome Полная поддержка 38Edge Полная поддержка 79Firefox Нет поддержки 16 — 52
Нет поддержки 16 — 52
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Полная поддержка 52
Замечания Отключено
Замечания Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery.
Отключено From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Полная поддержка 72
Замечания
Замечания From this version onwards, BatteryManager is only available in chrome/privileged code.
IE Нет поддержки НетOpera Полная поддержка 25Safari Нет поддержки НетWebView Android Полная поддержка 40Chrome Android Полная поддержка 38
Замечания
Полная поддержка 38
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
Firefox Android Нет поддержки 10 — 16
С префиксом
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Нет поддержки 16 — 52
Замечания Отключено
Замечания Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery.
Отключено From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android Полная поддержка 25Safari iOS Нет поддержки ? — ?Samsung Internet Android Полная поддержка 3.0
Замечания
Полная поддержка 3.0
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
onchargingtimechange
Устаревшая
Chrome Полная поддержка 38Edge Полная поддержка 79Firefox Нет поддержки 16 — 52
Нет поддержки 16 — 52
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Полная поддержка 52
Замечания Отключено
Замечания Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery.
Отключено From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Полная поддержка 72
Замечания
Замечания From this version onwards, BatteryManager is only available in chrome/privileged code.
IE Нет поддержки НетOpera Полная поддержка 25Safari Нет поддержки НетWebView Android Полная поддержка 40Chrome Android Полная поддержка 38
Замечания
Полная поддержка 38
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
Firefox Android Нет поддержки 10 — 16
С префиксом
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Нет поддержки 16 — 52
Замечания Отключено
Замечания Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery.
Отключено From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android Полная поддержка 25Safari iOS Нет поддержки ? — ?Samsung Internet Android Полная поддержка 3.0
Замечания
Полная поддержка 3.0
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
ondischargingtimechange
Устаревшая
Chrome Полная поддержка 38Edge Полная поддержка 79Firefox Нет поддержки 16 — 52
Нет поддержки 16 — 52
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Полная поддержка 52
Замечания Отключено
Замечания Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery.
Отключено From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Полная поддержка 72
Замечания
Замечания From this version onwards, BatteryManager is only available in chrome/privileged code.
IE Нет поддержки НетOpera Полная поддержка 25Safari Нет поддержки НетWebView Android Полная поддержка 40Chrome Android Полная поддержка 38
Замечания
Полная поддержка 38
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
Firefox Android Нет поддержки 10 — 16
С префиксом
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Нет поддержки 16 — 52
Замечания Отключено
Замечания Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery.
Отключено From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android Полная поддержка 25Safari iOS Нет поддержки ? — ?Samsung Internet Android Полная поддержка 3.0
Замечания
Полная поддержка 3.0
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
onlevelchange
Устаревшая
Chrome Полная поддержка 38Edge Полная поддержка 79Firefox Нет поддержки 16 — 52
Нет поддержки 16 — 52
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Полная поддержка 52
Замечания Отключено
Замечания Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery.
Отключено From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Полная поддержка 72
Замечания
Замечания From this version onwards, BatteryManager is only available in chrome/privileged code.
IE Нет поддержки НетOpera Полная поддержка 25Safari Нет поддержки НетWebView Android Полная поддержка 40Chrome Android Полная поддержка 38
Замечания
Полная поддержка 38
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.
Firefox Android Нет поддержки 10 — 16
С префиксом
Нет поддержки 10 — 16
С префиксом
С префиксом Требует вендорный префикс: moz
Нет поддержки 16 — 52
Замечания Отключено
Замечания Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery.
Отключено From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android Полная поддержка 25Safari iOS Нет поддержки ? — ?Samsung Internet Android Полная поддержка 3.0
Замечания
Полная поддержка 3.0
Замечания
Замечания Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.

Легенда

Полная поддержка  
Полная поддержка
Нет поддержки  
Нет поддержки
Устаревшая. Не следует использовать в новых веб-сайтах
Устаревшая. Не следует использовать в новых веб-сайтах
Смотрите замечания реализации.
Смотрите замечания реализации.
Пользователь должен сам включить эту возможность.
Пользователь должен сам включить эту возможность.
Требует вендорный префикс или другое имя для использования.
Требует вендорный префикс или другое имя для использования.

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