Battery Level

NOTE

The APIs of this module are no longer maintained since API version 7. It is recommended that you use @ohos.batteryInfo instead.

The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import battery from '@system.battery';

battery.getStatus

getStatus(Object): void

Obtains the current charging state and battery level.

System capability: SystemCapability.PowerManager.BatteryManager.Core

Parameter

Name	Type	Mandatory	Description
success	Function	No	Called when the check result is obtained
fail	Function	No	Called when the check result fails to be obtained
complete	Function	No	Called when the execution is complete

The following value will be returned when the check result is obtained.

Name	Type	Description
charging	boolean	Whether the battery is being charged
level	number	Current battery level, which ranges from 0.00 to 1.00.

Example

export default {    
  getStatus() {       
    battery.getStatus({           
      success: function(data) {               
        console.log('success get battery level:' + data.level);           
      },            
      fail: function(data, code) {                
        console.log('fail to get battery level code:' + code + ', data: ' + data);            
      },        
    });    
  },
}