Navigator: phương thức getBattery()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Phương thức getBattery() cung cấp thông tin về pin của hệ thống.
Nó trả về một lời hứa về pin, giải quyết bằng đối tượng BatteryManager cung cấp một số thuộc tính để biết trạng thái pin, đồng thời một số sự kiện bạn có thể xử lý để theo dõi trạng thái pin.
Điều này thực hiện Battery Status API; hãy xem tài liệu đó để biết thêm chi tiết, hướng dẫn sử dụng API và mã mẫu.
Kể từ Chrome 103, phương thức Navigator.getBattery() của Battery Status API chỉ hiển thị trong bối cảnh bảo mật.
[!LƯU Ý] Quyền truy cập vào tính năng này có thể được kiểm soát bởi chỉ thị
Permissions-Policybattery.
Cú pháp
getBattery()
Thông số
Không có.
Giá trị trả về
Promise đáp ứng đối tượng BatteryManager mà bạn có thể sử dụng để nhận thông tin về trạng thái của pin.
Ngoại lệ
NotAllowedErrorDOMException-
Việc sử dụng tính năng này đã bị Permissions Policy chặn.
SecurityErrorDOMException-
Tác nhân người dùng không tiết lộ thông tin về pin trong bối cảnh không an toàn và phương thức này được gọi từ bối cảnh không an toàn.
Ví dụ
Ví dụ này tìm nạp trạng thái sạc hiện tại của pin và thiết lập trình xử lý cho sự kiện chargingchange để trạng thái sạc được ghi lại bất cứ khi nào nó thay đổi.
let batteryIsCharging = false;
navigator.getBattery().then((battery) => {
batteryIsCharging = battery.charging;
battery.addEventListener("chargingchange", () => {
batteryIsCharging = battery.charging;
});
});
Để biết thêm ví dụ và chi tiết, hãy xem Battery Status API.
Thông số kỹ thuật
| Specification |
|---|
| Battery Status API # dom-navigator-getbattery |