Node-power-info NPM

node-power-info

Cross-platform node library for accessing battery and power adapter information

Features

Reads power status in percent, along with information on the charge mode of all installed batteries (charging, discharging, full, unknown) as well as the estimated remaining time until the battery is fully (dis-)charged.

Cross-platform

For the time being, only supports linux and darwin platforms. Windows is planned but it could take some time until I get to do that. If you think you can provide an implementation for windows or any other platform, feel free to make a pull request!

Known issues

Since I'm not owning a mac, the darwin implementation is completely untested. The current solution simply runs pmset -g batt to get basic information on the batteries installed and runs the output through a regex to extract percentage and charge status data. That should work in theory, but if you have time to test it in a real environment (possibly including some edge cases, like output when at 100%), please, take that time and report your findings!

How it works

To get information on the available batteries, the module sports a list of information providers that are each supported on different systems. When requiring the module, it first checks every provider for availability. The first found supported provider will be used as default provider for accessing battery information.

In this way, the module doesn't depend on node's require('os').type() value, but tries all available options for maximum compatibility.

Example

const powerInfo = require('node-power-info')

powerInfo.getDefault()
  .then(provider => provider.getBatteries())
  .then(batteries => batteries.forEach(battery => {
    console.dir(battery)
    console.log(`${battery.id} is at ${battery.powerLevel}% and ${battery.chargeStatus}.`)
    if (battery.isTimeAvailable) {
      const remainingMinutes = ('0' + battery.remainingTimeMinutes).slice(-2)
      console.log(`${battery.remainingTimeHours}:${remainingMinutes} remaining`)
    }
  }))