Spec-Zone.ru › Web APIs

Navigator: метод getBattery()

Ограниченная доступность

Эта функция не является базовой, так как она не работает во всех широко используемых браузерах.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.

Метод getBattery() предоставляет информацию о батарее системы. Он возвращает промис батареи, который разрешается объектом BatteryManager, предоставляющим некоторые свойства для получения состояния батареи, а также события, которые можно обработать для мониторинга состояния батареи. Это реализует API состояния батареи; для получения дополнительной информации, руководства по использованию API и примеров кода, обратитесь к этой документации.

Начиная с Chrome 103, метод Navigator.getBattery() API состояния батареи доступен только в безопасном контексте.

Примечание: Доступ к этой функции может контролироваться директивой Permissions-Policy battery.

Синтаксис

getBattery()

Параметры

Нет.

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

А Promise, который завершается объектом BatteryManager, с помощью которого можно получить информацию о состоянии батареи.

Исключения

NotAllowedError DOMException

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

SecurityError DOMException

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

Примеры

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

let batteryIsCharging = false;

navigator.getBattery().then((battery) => {
  batteryIsCharging = battery.charging;

  battery.addEventListener("chargingchange", () => {
    batteryIsCharging = battery.charging;
  });
});

Для получения дополнительных примеров и подробностей см. API состояния батареи.

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

Спецификация
API состояния батареи
# dom-navigator-getbattery

Совместимость с браузерами

Рабочие столы Мобильные
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
getBattery 38 79 43–52 25 Нет 38 43–52 25 Нет 3.0 38
secure_context_required 103 103 Нет Нет Нет 103 Нет 71 Нет 20.0 103

См. также

  • API состояния батареи
  • Permissions-Policy battery директива

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Navigator/getBattery

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API