Add auto-refresh for WebViewController after 5+ minutes in background with user setting (#4269)

Author: Copilot

Sources/App/Resources/en.lproj/Localizable.strings

@@ -844,6 +844,7 @@ Home Assistant is open source, advocates for privacy and runs locally in your ho
 "settings_details.general.body" = "Basic App configuration, App Icon and web page settings.";
 "settings_details.general.device_name.title" = "Device Name";
 "settings_details.general.full_screen.title" = "Full Screen";
+"settings_details.general.refresh_after_inactive.title" = "Refresh After 5 Min Inactive";
 "settings_details.general.launch_on_login.title" = "Launch App on Login";
 "settings_details.general.links.title" = "Links";
 "settings_details.general.menu_bar_text.title" = "Menu Bar Text";

Sources/App/Scenes/WebViewSceneDelegate.swift

@@ -11,6 +11,12 @@ final class WebViewSceneDelegate: NSObject, UIWindowSceneDelegate {
 
     private var updateDatabaseTask: Task<Void, Never>?
 
+    /// Stores the timestamp when the app enters background, used to determine if auto-refresh is needed on reactivation
+    var backgroundTimestamp: Date?
+
+    /// Time threshold (in seconds) after which WebViewController should refresh when returning from background
+    private let backgroundRefreshThreshold: TimeInterval = 5 * 60
+
     // swiftlint:disable cyclomatic_complexity
     func scene(
         _ scene: UIScene,
@@ -119,6 +125,9 @@ final class WebViewSceneDelegate: NSObject, UIWindowSceneDelegate {
         DataWidgetsUpdater.update()
         Current.modelManager.unsubscribe()
         Current.appDatabaseUpdater.stop()
+
+        // Record timestamp when app enters background
+        backgroundTimestamp = Date()
     }
 
     func sceneDidBecomeActive(_ scene: UIScene) {
@@ -128,6 +137,22 @@ final class WebViewSceneDelegate: NSObject, UIWindowSceneDelegate {
         }
         cleanWidgetsCache()
         updateLocation()
+
+        // Check if app was in background for 5 minutes or more
+        if let backgroundTimestamp {
+            let timeInterval = Date().timeIntervalSince(backgroundTimestamp)
+
+            if timeInterval >= backgroundRefreshThreshold, Current.settingsStore.refreshWebViewAfterInactive {
+                // Refresh WebViewController if it exists
+                // Note: webViewControllerPromise is a Guarantee, which cannot fail in PromiseKit
+                windowController?.webViewControllerPromise.done { webViewController in
+                    webViewController.refresh()
+                }
+            }
+
+            // Clear the timestamp
+            self.backgroundTimestamp = nil
+        }
     }
 
     func windowScene(

Sources/App/Settings/General/GeneralSettingsView.swift

@@ -44,6 +44,7 @@ struct GeneralSettingsView: View {
                 pageZoomPicker
                 pinchZoom
                 fullScreen
+                refreshAfterInactive
             }
         }
         .id(redrawHelper)
@@ -172,6 +173,18 @@ struct GeneralSettingsView: View {
         }
     }
 
+    @ViewBuilder
+    private var refreshAfterInactive: some View {
+        Toggle(isOn: .init(get: {
+            Current.settingsStore.refreshWebViewAfterInactive
+        }, set: { newValue in
+            Current.settingsStore.refreshWebViewAfterInactive = newValue
+            redrawView()
+        })) {
+            Text(L10n.SettingsDetails.General.RefreshAfterInactive.title)
+        }
+    }
+
     // MARK: - Mac
 
     #if targetEnvironment(macCatalyst)

Sources/Shared/Resources/Swiftgen/Strings.swift

@@ -3219,6 +3219,10 @@ public enum L10n {
         /// Pinch to Zoom
         public static var title: String { return L10n.tr("Localizable", "settings_details.general.pinch_to_zoom.title") }
       }
+      public enum RefreshAfterInactive {
+        /// Refresh After 5 Min Inactive
+        public static var title: String { return L10n.tr("Localizable", "settings_details.general.refresh_after_inactive.title") }
+      }
       public enum Restoration {
         /// Remember Last Page
         public static var title: String { return L10n.tr("Localizable", "settings_details.general.restoration.title") }

Sources/Shared/Settings/SettingsStore.swift

@@ -188,6 +188,19 @@ public class SettingsStore {
         }
     }
 
+    public var refreshWebViewAfterInactive: Bool {
+        get {
+            if let value = prefs.object(forKey: "refreshWebViewAfterInactive") as? NSNumber {
+                return value.boolValue
+            } else {
+                return true // Default to ON
+            }
+        }
+        set {
+            prefs.set(newValue, forKey: "refreshWebViewAfterInactive")
+        }
+    }
+
     public var macNativeFeaturesOnly: Bool {
         get {
             prefs.bool(forKey: "macNativeFeaturesOnly")