mirror of
https://github.com/BaaRai/ARTEX.git
synced 2026-11-19 06:30:54 +08:00
Adds setVisibleInterval (web/src/lib/polling.ts): no ticks while the tab is hidden, an immediate refresh on return, no overlapping polls, errors swallowed, cleanup removes the listener. API pollers use it; local clock ticks keep setInterval. CI runs the helper tests. Backported from #209 (contributed by @renaesop).
42 lines
1.4 KiB
TypeScript
Executable File
42 lines
1.4 KiB
TypeScript
Executable File
// Background browser tabs must not keep downloading snapshots. A poll that
|
|
// returns a promise completes before the next interval starts; focus refreshes
|
|
// immediately, without creating a second request while one is still running.
|
|
export function setVisibleInterval(callback: () => unknown | Promise<unknown>, delay: number): () => void {
|
|
let stopped = false;
|
|
let running = false;
|
|
let timer: ReturnType<typeof setTimeout> | undefined;
|
|
const visible = () => typeof document === "undefined" || document.visibilityState !== "hidden";
|
|
const clear = () => {
|
|
if (timer !== undefined) clearTimeout(timer);
|
|
timer = undefined;
|
|
};
|
|
const schedule = () => {
|
|
clear();
|
|
if (!stopped && visible()) timer = setTimeout(() => void run(), delay);
|
|
};
|
|
const run = async () => {
|
|
clear();
|
|
if (stopped || running || !visible()) return;
|
|
running = true;
|
|
try {
|
|
await callback();
|
|
} catch {
|
|
// Existing loaders own their error UI; transient polling failures retry.
|
|
} finally {
|
|
running = false;
|
|
schedule();
|
|
}
|
|
};
|
|
const onVisibility = () => {
|
|
clear();
|
|
if (visible()) void run();
|
|
};
|
|
if (typeof document !== "undefined") document.addEventListener("visibilitychange", onVisibility);
|
|
schedule();
|
|
return () => {
|
|
stopped = true;
|
|
clear();
|
|
if (typeof document !== "undefined") document.removeEventListener("visibilitychange", onVisibility);
|
|
};
|
|
}
|