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

This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 57).

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!