feat: add option to refresh on visibilitychange event

src/lib/useOnVisibilityChange.ts

@@ -0,0 +1,18 @@
+import { DependencyList, useEffect } from "react";
+import { isBrowser } from "browser-or-node";
+
+type Callback = () => void;
+
+export const useOnVisibilityChange = (
+  cb: Callback,
+  deps: DependencyList,
+): void => {
+  useEffect(() => {
+    if (isBrowser) {
+      document.addEventListener("visibilitychange", cb);
+      return () => {
+        document.removeEventListener("visibilitychange", cb);
+      };
+    }
+  }, deps);
+};

src/resource/types.ts

@@ -24,6 +24,7 @@ export type UseWatchResourceOptions = {
   useSuspense?: boolean;
   autoRefresh?: DurationLikeObject;
   refreshOnWindowFocus?: boolean;
+  refreshOnVisibilityChange?: boolean;
 } & GetAsyncResourceOptions;
 
 export type NoSuspenseReturnType<T> = Readonly<

src/resource/useWatchResourceValue.test.tsx

@@ -119,6 +119,35 @@ test("focus event does not trigger resource refresh, if 'refreshOnWindowFocus' i
   expectValue("Foo");
 });
 
+test("visibilitychange event triggers resource refresh, if 'refreshOnVisibilityChange' is enabled", async () => {
+  options.refreshOnVisibilityChange = true;
+  render(<TestView />);
+  await waitToBeLoaded();
+  expectValue("Foo");
+
+  getName.mockReturnValue("Bar");
+  act(() => {
+    document.dispatchEvent(new Event("visibilitychange"));
+  });
+
+  await waitToBeLoaded();
+  expectValue("Bar");
+});
+
+test("visibilitychange event does not trigger resource refresh, if 'refreshOnVisibilityChange' is not enabled", async () => {
+  render(<TestView />);
+  await waitToBeLoaded();
+  expectValue("Foo");
+
+  getName.mockReturnValue("Bar");
+  act(() => {
+    document.dispatchEvent(new Event("visibilitychange"));
+  });
+
+  await waitToBeLoaded();
+  expectValue("Foo");
+});
+
 describe("with disabled suspense", () => {
   beforeEach(() => {
     options.useSuspense = false;

src/resource/useWatchResourceValue.ts

@@ -4,6 +4,7 @@ import { useWatchObservableValue } from "../observable-value/useWatchObservableV
 import { UseWatchResourceOptions, UseWatchResourceResult } from "./types.js";
 import { hash } from "object-code";
 import { useOnWindowFocused } from "../lib/useOnWindowFocused.js";
+import { useOnVisibilityChange } from "../lib/useOnVisibilityChange.js";
 
 export const useWatchResourceValue = <
   T,
@@ -18,6 +19,7 @@ export const useWatchResourceValue = <
     keepValueWhileLoading = true,
     useSuspense = true,
     refreshOnWindowFocus = false,
+    refreshOnVisibilityChange = false,
     autoRefresh,
   } = options;
 
@@ -37,6 +39,12 @@ export const useWatchResourceValue = <
     }
   }, [resource, refreshOnWindowFocus]);
 
+  useOnVisibilityChange(() => {
+    if (refreshOnVisibilityChange && document.visibilityState === "visible") {
+      resource.refresh();
+    }
+  }, [resource, refreshOnVisibilityChange]);
+
   setTimeout(() => {
     void resource.load();
   }, 0);