cordova.plugins.diagnostic 7.2.10 → 7.3.0

package/cordova.plugins.diagnostic.d.ts

@@ -741,6 +741,46 @@ interface Diagnostic {
         errorCallback: (error: string) => void
     ) => void;
 
+    /**
+     * Checks if low power mode is currently enabled on the device.
+     * @param successCallback
+     * @param errorCallback
+     */
+    isLowPowerModeEnabled?: (
+        successCallback: (enabled: boolean) => void,
+        errorCallback: (error: string) => void
+    ) => void;
+
+    /**
+     * Registers a function to be called when low power mode changes.
+     * @param successCallback
+     */
+    onLowPowerModeChange?: (
+        successCallback: (enabled: boolean) => void
+    ) => void;
+
+    /**
+     * ANDROID ONLY
+     * Checks if the app is currently ignoring battery optimizations.
+     * @param successCallback
+     * @param errorCallback
+     */
+    isIgnoringBatteryOptimizations?: (
+        successCallback: (enabled: boolean) => void,
+        errorCallback: (error: string) => void
+    ) => void;
+
+    /**
+     * ANDROID ONLY
+     * Prompts the user to allow the app to ignore battery optimizations.
+     * @param successCallback
+     * @param errorCallback
+     */
+    requestIgnoreBatteryOptimizations?: (
+        successCallback: () => void,
+        errorCallback: (error: string) => void
+    ) => void;
+
     /**
      * ANDROID ONLY
      * Checks if high-accuracy locations are available to the app from GPS hardware.

package/package.json

@@ -1,5 +1,5 @@
 {
-    "version": "7.2.10",
+    "version": "7.3.0",
     "name": "cordova.plugins.diagnostic",
     "cordova_name": "Diagnostic",
     "description": "Cordova/Phonegap plugin to check the state of Location/WiFi/Camera/Bluetooth device settings.",

package/plugin.xml

@@ -2,7 +2,7 @@
 <plugin xmlns="http://www.phonegap.com/ns/plugins/1.0"
     xmlns:android="http://schemas.android.com/apk/res/android"
     id="cordova.plugins.diagnostic"
-    version="7.2.10">
+    version="7.3.0">
 
     <name>Diagnostic</name>
     <description>Cordova/Phonegap plugin to check the state of Location/WiFi/Camera/Bluetooth device settings.</description>

package/src/android/Diagnostic.java

@@ -46,13 +46,16 @@ import android.Manifest;
 import android.app.Activity;
 import android.app.AlarmManager;
 import android.app.PendingIntent;
+import android.content.BroadcastReceiver;
 import android.content.SharedPreferences;
+import android.content.IntentFilter;
 import android.content.pm.ApplicationInfo;
 import android.content.pm.PackageInfo;
 import android.net.ConnectivityManager;
 import android.net.Uri;
 import android.os.BatteryManager;
 import android.os.Build;
+import android.os.PowerManager;
 import android.util.Log;
 
 import android.content.Context;
@@ -263,6 +266,7 @@ public class Diagnostic extends CordovaPlugin{
 
     protected SharedPreferences sharedPref;
     protected SharedPreferences.Editor editor;
+    protected boolean currentLowPowerModeEnabled = false;
 
     /*************
      * Public API
@@ -291,10 +295,31 @@ public class Diagnostic extends CordovaPlugin{
         applicationContext = this.cordova.getActivity().getApplicationContext();
         sharedPref = cordova.getActivity().getSharedPreferences(TAG, Activity.MODE_PRIVATE);
         editor = sharedPref.edit();
+        currentLowPowerModeEnabled = isLowPowerModeEnabled();
+
+        if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP){
+            try {
+                applicationContext.registerReceiver(lowPowerModeChangedReceiver, new IntentFilter(PowerManager.ACTION_POWER_SAVE_MODE_CHANGED));
+            } catch (Exception e) {
+                logWarning("Unable to register low power mode change receiver: " + e.getMessage());
+            }
+        }
 
         super.initialize(cordova, webView);
     }
 
+    @Override
+    public void onDestroy() {
+        if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP){
+            try {
+                applicationContext.unregisterReceiver(lowPowerModeChangedReceiver);
+            } catch (Exception e) {
+                logWarning("Unable to unregister low power mode change receiver: " + e.getMessage());
+            }
+        }
+        super.onDestroy();
+    }
+
     /**
      * Executes the request and returns PluginResult.
      *
@@ -351,6 +376,13 @@ public class Diagnostic extends CordovaPlugin{
                 callbackContext.success(getCPUArchitecture());
             } else if(action.equals("getCurrentBatteryLevel")) {
                 callbackContext.success(getCurrentBatteryLevel());
+            } else if(action.equals("isLowPowerModeEnabled")) {
+                callbackContext.success(isLowPowerModeEnabled() ? 1 : 0);
+            } else if(action.equals("isIgnoringBatteryOptimizations")) {
+                callbackContext.success(isIgnoringBatteryOptimizations() ? 1 : 0);
+            } else if(action.equals("requestIgnoreBatteryOptimizations")) {
+                requestIgnoreBatteryOptimizations();
+                callbackContext.success();
             } else if(action.equals("isAirplaneModeEnabled")) {
                 callbackContext.success(isAirplaneModeEnabled() ? 1 : 0);
             } else if(action.equals("getDeviceOSVersion")) {
@@ -861,6 +893,17 @@ public class Diagnostic extends CordovaPlugin{
         executeGlobalJavascript("cordova.plugins.diagnostic." + jsString);
     }
 
+    protected final BroadcastReceiver lowPowerModeChangedReceiver = new BroadcastReceiver() {
+        @Override
+        public void onReceive(Context context, Intent intent) {
+            final String action = intent.getAction();
+            if(instance != null && PowerManager.ACTION_POWER_SAVE_MODE_CHANGED.equals(action)){
+                Log.v(TAG, "lowPowerModeChangedReceiver");
+                instance.notifyLowPowerModeChange();
+            }
+        }
+    };
+
     /**
      * Performs a warm app restart - restarts only Cordova main activity
      */
@@ -953,6 +996,41 @@ public class Diagnostic extends CordovaPlugin{
         return bm.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY);
     }
 
+    protected boolean isLowPowerModeEnabled(){
+        if(Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP){
+            return false;
+        }
+        PowerManager powerManager = (PowerManager) cordova.getContext().getApplicationContext().getSystemService(Context.POWER_SERVICE);
+        return powerManager != null && powerManager.isPowerSaveMode();
+    }
+
+    protected boolean isIgnoringBatteryOptimizations(){
+        if(Build.VERSION.SDK_INT < Build.VERSION_CODES.M){
+            return true;
+        }
+        PowerManager powerManager = (PowerManager) cordova.getContext().getApplicationContext().getSystemService(Context.POWER_SERVICE);
+        return powerManager != null && powerManager.isIgnoringBatteryOptimizations(cordova.getActivity().getPackageName());
+    }
+
+    protected void requestIgnoreBatteryOptimizations(){
+        if(Build.VERSION.SDK_INT < Build.VERSION_CODES.M || isIgnoringBatteryOptimizations()){
+            return;
+        }
+
+        Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
+        intent.setData(Uri.parse("package:" + cordova.getActivity().getPackageName()));
+        cordova.getActivity().startActivity(intent);
+    }
+
+    protected void notifyLowPowerModeChange(){
+        boolean lowPowerModeEnabled = isLowPowerModeEnabled();
+        if(lowPowerModeEnabled != currentLowPowerModeEnabled){
+            currentLowPowerModeEnabled = lowPowerModeEnabled;
+            logDebug("Low power mode changed to: " + lowPowerModeEnabled);
+            executePluginJavascript("_onLowPowerModeChange(" + (lowPowerModeEnabled ? "true" : "false") + ");");
+        }
+    }
+
     // https://stackoverflow.com/a/18237962/777265
     protected boolean hasBuildPermission(String permission)
     {

package/src/ios/Diagnostic.h

@@ -28,6 +28,7 @@ extern NSString*const AUTHORIZATION_LIMITED;
 
 @property (nonatomic) float osVersion;
 @property (nonatomic) BOOL debugEnabled;
+@property (nonatomic, strong) id lowPowerModeChangeObserver;
 
 // Plugin API
 - (void) enableDebug: (CDVInvokedUrlCommand*)command;
@@ -35,6 +36,7 @@ extern NSString*const AUTHORIZATION_LIMITED;
 - (void) getBackgroundRefreshStatus: (CDVInvokedUrlCommand*)command;
 - (void) getArchitecture: (CDVInvokedUrlCommand*)command;
 - (void) getCurrentBatteryLevel: (CDVInvokedUrlCommand*)command;
+- (void) isLowPowerModeEnabled: (CDVInvokedUrlCommand*)command;
 - (void) getDeviceOSVersion: (CDVInvokedUrlCommand*)command;
 - (void) getBuildOSVersion: (CDVInvokedUrlCommand*)command;
 - (void) isMobileDataAuthorized: (CDVInvokedUrlCommand*)command;

package/src/ios/Diagnostic.m

@@ -41,6 +41,7 @@ static Diagnostic* diagnostic = nil;
 static CTCellularData* cellularData;
 #endif
 
+
 /********************************/
 #pragma mark - Public static functions
 /********************************/
@@ -126,6 +127,12 @@ static CTCellularData* cellularData;
     #if !TARGET_OS_MACCATALYST
         cellularData = [[CTCellularData alloc] init];
     #endif
+
+    self.lowPowerModeChangeObserver = [[NSNotificationCenter defaultCenter] addObserverForName:NSProcessInfoPowerStateDidChangeNotification object:nil queue:[NSOperationQueue mainQueue] usingBlock:^(NSNotification *notification) {
+        BOOL isLowPowerModeEnabled = [[NSProcessInfo processInfo] isLowPowerModeEnabled];
+        [self logDebug:[NSString stringWithFormat:@"Low power mode changed to: %@", isLowPowerModeEnabled ? @"true" : @"false"]];
+        [self executeGlobalJavascript:[NSString stringWithFormat:@"cordova.plugins.diagnostic._onLowPowerModeChange(%@);", isLowPowerModeEnabled ? @"true" : @"false"]];
+    }];
 }
 
 // https://stackoverflow.com/a/38441011/777265
@@ -186,6 +193,18 @@ static CTCellularData* cellularData;
     }];
 }
 
+- (void) isLowPowerModeEnabled: (CDVInvokedUrlCommand*)command {
+    [self.commandDelegate runInBackground:^{
+        @try {
+            BOOL isLowPowerModeEnabled = [[NSProcessInfo processInfo] isLowPowerModeEnabled];
+            [self logDebug:[NSString stringWithFormat:@"Low power mode enabled: %@", isLowPowerModeEnabled ? @"true" : @"false"]];
+            [self sendPluginResultBool:isLowPowerModeEnabled :command];
+        }@catch (NSException *exception) {
+            [self handlePluginException:exception :command];
+        }
+    }];
+}
+
 - (void) getDeviceOSVersion: (CDVInvokedUrlCommand*)command {
     [self.commandDelegate runInBackground:^{
         @try {
@@ -419,6 +438,13 @@ static CTCellularData* cellularData;
     return [[NSUserDefaults standardUserDefaults] objectForKey:key];
 }
 
+- (void)dealloc {
+    if(self.lowPowerModeChangeObserver != nil){
+        [[NSNotificationCenter defaultCenter] removeObserver:self.lowPowerModeChangeObserver];
+        self.lowPowerModeChangeObserver = nil;
+    }
+}
+
 @end
 
 

package/src/ios/Diagnostic_Bluetooth.m

@@ -156,12 +156,14 @@ static NSString*const LOG_TAG = @"Diagnostic_Bluetooth[native]";
 }
 
 - (void) ensureBluetoothManager {
-    if(![self.bluetoothManager isKindOfClass:[CBCentralManager class]]){
+    @synchronized(self) {
+      if(![self.bluetoothManager isKindOfClass:[CBCentralManager class]]){
         self.bluetoothManager = [[CBCentralManager alloc]
                                  initWithDelegate:self
                                  queue:dispatch_get_main_queue()
                                  options:@{CBCentralManagerOptionShowPowerAlertKey: @(NO)}];
         [self centralManagerDidUpdateState:self.bluetoothManager]; // Send initial state
+      }
     }
 }
 

package/www/android/diagnostic.js

@@ -112,7 +112,8 @@ var Diagnostic = (function(){
      *
      ****************************/
     // Placeholder listeners
-    Diagnostic._onNFCStateChange =
+    Diagnostic._onLowPowerModeChange =
+        Diagnostic._onNFCStateChange =
         Diagnostic._onPermissionRequestComplete = function(){};
 
     Diagnostic._combinePermissionStatuses = function(statuses){
@@ -484,6 +485,63 @@ var Diagnostic = (function(){
             []);
     };
 
+    /**
+     * Checks if low power mode is currently enabled on device.
+     *
+     * @param {Function} successCallback -  The callback which will be called when the operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if low power mode is enabled.
+     * @param {Function} errorCallback -  The callback which will be called when the operation encounters an error.
+     *  This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic.isLowPowerModeEnabled = function(successCallback, errorCallback){
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic',
+            'isLowPowerModeEnabled',
+            []);
+    };
+
+    /**
+     * Checks if the app is currently ignoring battery optimizations.
+     *
+     * @param {Function} successCallback -  The callback which will be called when the operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if the app is ignoring battery optimizations.
+     * @param {Function} errorCallback -  The callback which will be called when the operation encounters an error.
+     *  This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic.isIgnoringBatteryOptimizations = function(successCallback, errorCallback){
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic',
+            'isIgnoringBatteryOptimizations',
+            []);
+    };
+
+    /**
+     * Prompts the user to allow the app to ignore battery optimizations.
+     *
+     * @param {Function} successCallback - The callback which will be called when the request intent is opened.
+     * @param {Function} errorCallback - The callback which will be called when the operation encounters an error.
+     * This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic.requestIgnoreBatteryOptimizations = function(successCallback, errorCallback){
+        return cordova.exec(successCallback,
+            errorCallback,
+            'Diagnostic',
+            'requestIgnoreBatteryOptimizations',
+            []);
+    };
+
+    /**
+     * Registers a function to be called when the device low power mode changes.
+     *
+     * @param {Function} successCallback - The callback which will be called when low power mode changes.
+     * This callback function is passed a single boolean parameter which is TRUE if low power mode is enabled.
+     */
+    Diagnostic.onLowPowerModeChange = function(successCallback) {
+        Diagnostic._onLowPowerModeChange = successCallback || function(){};
+    };
+
     /**
      * Checks if airplane mode is enabled on device.
      *

package/www/ios/diagnostic.js

@@ -154,6 +154,32 @@ var Diagnostic = (function(){
             []);
     };
 
+    /**
+     * Checks if low power mode is currently enabled on device.
+     *
+     * @param {Function} successCallback -  The callback which will be called when the operation is successful.
+     * This callback function is passed a single boolean parameter which is TRUE if low power mode is enabled.
+     * @param {Function} errorCallback -  The callback which will be called when the operation encounters an error.
+     *  This callback function is passed a single string parameter containing the error message.
+     */
+    Diagnostic.isLowPowerModeEnabled = function(successCallback, errorCallback){
+        return cordova.exec(Diagnostic._ensureBoolean(successCallback),
+            errorCallback,
+            'Diagnostic',
+            'isLowPowerModeEnabled',
+            []);
+    };
+
+    /**
+     * Registers a function to be called when the device low power mode changes.
+     *
+     * @param {Function} successCallback - The callback which will be called when low power mode changes.
+     * This callback function is passed a single boolean parameter which is TRUE if low power mode is enabled.
+     */
+    Diagnostic.onLowPowerModeChange = function(successCallback) {
+        Diagnostic._onLowPowerModeChange = successCallback || function(){};
+    };
+
     /**
      * Checks if mobile data is authorized for this app.
      * Returns true if the per-app Mobile Data setting is set to enabled (regardless of whether the device is currently connected to a cellular network)
@@ -1228,7 +1254,7 @@ var Diagnostic = (function(){
         }
     };
 
-
+    Diagnostic._onLowPowerModeChange = function(){};
 
     return Diagnostic;
 })();

package/.specstory/.project.json

@@ -1,8 +0,0 @@
-{
-  "workspace_id": "3d27-7072-f841-12e1",
-  "workspace_id_at": "2026-02-24T14:03:38.792Z",
-  "project_name": "cordova-diagnostic-plugin",
-  "cloud_sync": false,
-  "git_id": "303b-c6e9-a865-86a3",
-  "git_id_at": "2026-02-24T14:03:38.810Z"
-}