Debug Mode

Enable Debug Mode

Set debug: true in your configuration. Optionally enable debugSounds: true for audio feedback.

import { BackgroundLocation } from '@bglocation/capacitor';

await BackgroundLocation.configure({
  distanceFilter: 15,
  desiredAccuracy: 'high',
  heartbeatInterval: 15,
  debug: true,         // enable verbose logs
  debugSounds: true,   // play system sounds on events (iOS)
});

// Listen for debug messages
BackgroundLocation.addListener('onDebug', (event) => {
  console.log(`[DEBUG ${new Date(event.timestamp).toISOString()}] ${event.message}`);
});

await BackgroundLocation.start();

What Debug Mode Does

DebugEvent Interface

interface DebugEvent {
  message: string;     // debug log message
  timestamp: number;   // epoch milliseconds
}

Physical Device vs Simulator