isIgnoringBatteryOptimizations

Check if the app is exempt from battery optimizations

Overview

Checks if the app is currently exempt from battery optimizations. When an app is ignoring battery optimizations, it can run background tasks more freely without being restricted by Doze mode and App Standby.

function isIgnoringBatteryOptimizations(): Promise<boolean>

Returns

isIgnoring · boolean

Promise resolving to true if the app is ignoring battery optimizations (exempt from Doze restrictions), false otherwise.

Platform Behavior

Platform	Behavior
Android	Checks if the app is whitelisted from Doze mode and App Standby using PowerManager.isIgnoringBatteryOptimizations(). Available on API 23+ (Android 6.0+). Returns false on older versions.
iOS	Always returns true as the concept doesn’t apply in the same way. iOS manages background execution through Background Modes.

What Are Battery Optimizations?

Battery optimizations were introduced in Android 6.0 (API 23) as part of Doze mode. When an app is NOT ignoring battery optimizations, the system may:

• ❌ Defer background work and jobs
• ❌ Restrict network access when idle
• ❌ Delay alarms and timers
• ❌ Stop location updates
• ❌ Prevent wake locks from working

When an app IS ignoring battery optimizations:

• ✅ Background tasks run normally
• ✅ Network access maintained
• ✅ Wake locks function properly
• ✅ Location updates continue

Example Usage

Check and Request Exemption

import { isIgnoringBatteryOptimizations, requestBatteryOptimizationExemption } from 'react-native-background-guardian';

const isIgnoring = await isIgnoringBatteryOptimizations();

if (!isIgnoring) {
  // App is subject to battery optimizations
  Alert.alert(
    'Background Access',
    'This app needs to run in the background. Please allow it to ignore battery optimizations.',
    [
      { text: 'Cancel', style: 'cancel' },
      { 
        text: 'Allow', 
        onPress: async () => {
          await requestBatteryOptimizationExemption();
        }
      }
    ]
  );
}

Startup Check

import { useEffect } from 'react';
import { isIgnoringBatteryOptimizations } from 'react-native-background-guardian';

function App() {
  useEffect(() => {
    const checkStatus = async () => {
      const isIgnoring = await isIgnoringBatteryOptimizations();
      
      if (isIgnoring) {
        console.log('✅ App can run freely in background');
      } else {
        console.log('⚠️ App may be restricted in background');
      }
    };

    checkStatus();
  }, []);

  return <AppContent />;
}

Status Display

import { useState, useEffect } from 'react';
import { isIgnoringBatteryOptimizations } from 'react-native-background-guardian';

function BatteryOptimizationStatus() {
  const [status, setStatus] = useState<'checking' | 'exempt' | 'restricted'>('checking');

  useEffect(() => {
    const checkStatus = async () => {
      const isIgnoring = await isIgnoringBatteryOptimizations();
      setStatus(isIgnoring ? 'exempt' : 'restricted');
    };

    checkStatus();
  }, []);

  return (
    <View>
      <Text>Battery Optimization Status:</Text>
      {status === 'checking' && <Text>Checking...</Text>}
      {status === 'exempt' && <Text style={{ color: 'green' }}>✓ Exempt</Text>}
      {status === 'restricted' && <Text style={{ color: 'orange' }}>⚠ Restricted</Text>}
    </View>
  );
}

Before Starting Background Service

import { isIgnoringBatteryOptimizations, requestBatteryOptimizationExemption } from 'react-native-background-guardian';

async function startBackgroundService() {
  const isIgnoring = await isIgnoringBatteryOptimizations();
  
  if (!isIgnoring) {
    const proceed = await showConfirmDialog(
      'Background service may be restricted. Request exemption?'
    );
    
    if (proceed) {
      await requestBatteryOptimizationExemption();
    } else {
      console.warn('Starting service without battery optimization exemption');
    }
  }
  
  // Start the service
  await initializeBackgroundService();
}

Settings Screen

import { isIgnoringBatteryOptimizations, openBatteryOptimizationSettings } from 'react-native-background-guardian';

function SettingsScreen() {
  const [isIgnoring, setIsIgnoring] = useState(false);

  const checkStatus = async () => {
    const status = await isIgnoringBatteryOptimizations();
    setIsIgnoring(status);
  };

  useEffect(() => {
    checkStatus();
  }, []);

  return (
    <View>
      <Text>Battery Optimization: {isIgnoring ? 'Disabled' : 'Enabled'}</Text>
      <Button 
        title="Open Settings" 
        onPress={() => openBatteryOptimizationSettings()}
      />
    </View>
  );
}

Difference from Power Save Mode

isIgnoringBatteryOptimizations() is different from isPowerSaveMode():

Feature	Battery Optimizations	Power Save Mode
Scope	Per-app setting	System-wide setting
Control	User grants to specific apps	User enables globally
When active	Always (unless exempt)	Only when Battery Saver on
Can be bypassed	Yes (with exemption)	Affects all apps

An app can be exempt from battery optimizations but still be affected when the user enables Power Save mode.

Related APIs

• requestBatteryOptimizationExemption() - Request exemption
• openBatteryOptimizationSettings() - Open settings
• isPowerSaveMode() - Check Battery Saver status
• isDeviceIdleMode() - Check Doze mode status