Navigator: метод getBattery()
Ограниченная доступность
Эта функция не является базовой, так как она не работает во всех широко используемых браузерах.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.
Метод getBattery() предоставляет информацию о батарее системы. Он возвращает промис батареи, который разрешается объектом BatteryManager, предоставляющим некоторые свойства для получения состояния батареи, а также события, которые можно обработать для мониторинга состояния батареи. Это реализует API состояния батареи; для получения дополнительной информации, руководства по использованию API и примеров кода, обратитесь к этой документации.
Начиная с Chrome 103, метод Navigator.getBattery() API состояния батареи доступен только в безопасном контексте.
Примечание: Доступ к этой функции может контролироваться директивой Permissions-Policy battery.
Синтаксис
getBattery()
Параметры
Нет.
Возвращаемое значение
А Promise, который завершается объектом BatteryManager, с помощью которого можно получить информацию о состоянии батареи.
Исключения
-
NotAllowedErrorDOMException -
Использование этой функции было заблокировано политикой разрешений.
-
SecurityErrorDOMException -
Пользовательский агент не предоставляет информацию о батарее в небезопасных контекстах, и этот метод был вызван из небезопасного контекста.
Примеры
В этом примере извлекается текущее состояние зарядки батареи и устанавливается обработчик события 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-Policybatteryдиректива
© 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