This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

expo-battery provides battery information for the physical device (such as battery level, whether or not the device is charging, and more) as well as corresponding event listeners.

Note: On web, expo-battery relies on the Battery Status API, which is only implemented in Chromium-based browsers (Chrome, Edge, Opera). On unsupported browsers, getBatteryLevelAsync() resolves to -1 and getBatteryStateAsync() resolves to BatteryState.UNKNOWN.

Installation

If you are installing this in an existing React Native app, make sure to install expo in your project.

Usage

import { useBatteryLevel } from 'expo-battery';
import { StyleSheet, Text, View } from 'react-native';

export default function App() {
  const batteryLevel = useBatteryLevel();

  return (
    <View style={styles.container}>
      <Text>Current Battery Level: {batteryLevel}</Text>
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    marginTop: 15,
    alignItems: 'center',
    justifyContent: 'center',
  },
});

API

import * as Battery from 'expo-battery';

No API data file found, sorry!