1# 电量信息 2 3> **说明：** 4> - 从API Version 6开始，该接口不再维护，推荐使用新接口[`@ohos.batteryInfo`](js-apis-battery-info.md)。 5> 6> - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 7 8 9## 导入模块 10 11 12```js 13import battery from '@system.battery'; 14``` 15 16 17## battery.getStatus 18 19getStatus(Object): void 20 21获取设备当前的充电状态及剩余电量。 22 23**系统能力：** SystemCapability.PowerManager.BatteryManager.Core 24 25**参数：** 26 27| 参数名 | 类型 | 必填 | 说明 | 28| -------- | -------- | -------- | -------- | 29| success | (data: [BatteryResponse](#batteryresponse)) => void | 否 | 接口调用成功的回调函数。| 30| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。| 31| complete | () => void | 否 | 接口调用结束的回调函数。 | 32 33**示例：** 34 35```js 36export default { 37 getStatus() { 38 battery.getStatus({ 39 success: function(data) { 40 console.log('success get battery level:' + data.level); 41 }, 42 fail: function(data, code) { 43 console.log('fail to get battery level code:' + code + ', data: ' + data); 44 }, 45 }); 46 }, 47} 48``` 49 50## BatteryResponse 51 52| 参数名 | 类型 | 说明 | 53| -------- | -------- | -------- | 54| charging | boolean | 当前电池是否在充电中。 | 55| level | number | 当前电池的电量，取值范围：0.00 - 1.00 。 | 56