Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import {
ROUTE_STATE_REPLACE_OPTIONS,
createRouteStateNavigateScheduler,
markRouteStateDeliberateScroll,
} from '@/utils/routeStateNavigation';
import {
clearPendingAppShellRestoreTop,
readPendingAppShellRestoreTop,
} from '@/utils/appShellScrollRestoration';
describe('routeStateNavigation', () => {
const scrollToSpy = vi.fn();
let currentScrollX = 24;
let currentScrollY = 320;
beforeEach(() => {
vi.useFakeTimers();
clearPendingAppShellRestoreTop();
scrollToSpy.mockReset();
currentScrollX = 24;
currentScrollY = 320;
Object.defineProperty(window, 'scrollX', {
configurable: true,
get: () => currentScrollX,
});
Object.defineProperty(window, 'scrollY', {
configurable: true,
get: () => currentScrollY,
});
Object.defineProperty(window.navigator, 'userAgent', {
configurable: true,
value: 'Mozilla/5.0',
});
Object.defineProperty(window.history, 'scrollRestoration', {
configurable: true,
value: 'auto',
writable: true,
});
scrollToSpy.mockImplementation((x: number, y: number) => {
currentScrollX = x;
currentScrollY = y;
});
window.scrollTo = scrollToSpy as typeof window.scrollTo;
});
afterEach(() => {
vi.useRealTimers();
});
it('preserves scroll when replacing query state on the same pathname', () => {
const navigate = vi.fn();
let currentPath = '/proxmox/overview?type=app-container';
const scheduler = createRouteStateNavigateScheduler(navigate, () => currentPath);
scheduler.schedule('/proxmox/overview?type=app-container&resource=agent-123');
vi.runAllTimers();
expect(navigate).toHaveBeenCalledWith(
'/proxmox/overview?type=app-container&resource=agent-123',
ROUTE_STATE_REPLACE_OPTIONS,
);
expect(scrollToSpy).toHaveBeenCalledWith(24, 320);
scheduler.cleanup();
});
it('cancels deferred same-path scroll restoration when cleaned up', () => {
const navigate = vi.fn();
let currentPath = '/proxmox/overview?type=app-container';
const scheduler = createRouteStateNavigateScheduler(navigate, () => currentPath);
scheduler.schedule('/proxmox/overview?type=app-container&resource=agent-123');
vi.advanceTimersByTime(0);
expect(navigate).toHaveBeenCalledWith(
'/proxmox/overview?type=app-container&resource=agent-123',
ROUTE_STATE_REPLACE_OPTIONS,
);
expect(scrollToSpy).toHaveBeenCalledTimes(1);
scheduler.cleanup();
vi.runAllTimers();
expect(scrollToSpy).toHaveBeenCalledTimes(1);
});
it('captures the app scroll shell before same-path route state navigation', () => {
const navigate = vi.fn();
let currentPath = '/proxmox/overview?type=app-container';
const scheduler = createRouteStateNavigateScheduler(navigate, () => currentPath);
const shell = document.createElement('div');
shell.className = 'app-scroll-shell';
shell.scrollTop = 55;
document.body.appendChild(shell);
scheduler.schedule('/proxmox/overview?type=app-container&resource=agent-123');
vi.runAllTimers();
expect(navigate).toHaveBeenCalledWith(
'/proxmox/overview?type=app-container&resource=agent-123',
ROUTE_STATE_REPLACE_OPTIONS,
);
expect(readPendingAppShellRestoreTop()).toBe(55);
});
it('drops a pending rewrite after the user navigates to a different pathname (#1557)', () => {
const navigate = vi.fn();
let currentPath = '/proxmox/storage';
const scheduler = createRouteStateNavigateScheduler(navigate, () => currentPath);
// The storage surface schedules its query write-back, then the user
// clicks the Overview section tab before the setTimeout(0) fires.
scheduler.schedule('/proxmox/storage?source=proxmox-pve');
currentPath = '/proxmox/overview';
vi.runAllTimers();
expect(navigate).not.toHaveBeenCalled();
scheduler.cleanup();
});
it('re-anchors a coalesced rewrite to the pathname of the latest schedule call', () => {
const navigate = vi.fn();
let currentPath = '/proxmox/backups';
const scheduler = createRouteStateNavigateScheduler(navigate, () => currentPath);
scheduler.schedule('/proxmox/backups?node=pve1');
// A second schedule arrives after navigation; the pending rewrite must be
// judged against the pathname that scheduled it last, not the first one.
currentPath = '/proxmox/overview';
scheduler.schedule('/proxmox/overview?type=vm');
vi.runAllTimers();
expect(navigate).toHaveBeenCalledWith('/proxmox/overview?type=vm', ROUTE_STATE_REPLACE_OPTIONS);
scheduler.cleanup();
});
it('skips redundant navigations to the current path', () => {
const navigate = vi.fn();
const scheduler = createRouteStateNavigateScheduler(
navigate,
() => '/proxmox/backups?rollupId=abc',
);
scheduler.schedule('/proxmox/backups?rollupId=abc');
vi.runAllTimers();
expect(navigate).not.toHaveBeenCalled();
expect(scrollToSpy).not.toHaveBeenCalled();
scheduler.cleanup();
});
it('stops replaying preserved scroll after a later deliberate scroll change', () => {
const navigate = vi.fn();
let currentPath = '/proxmox/overview?type=app-container';
const scheduler = createRouteStateNavigateScheduler(navigate, () => currentPath);
scheduler.schedule('/proxmox/overview?type=app-container&resource=agent-123');
vi.advanceTimersByTime(0);
expect(scrollToSpy).toHaveBeenCalledTimes(1);
currentScrollY = 540;
vi.runAllTimers();
expect(scrollToSpy).toHaveBeenCalledTimes(1);
});
it('suppresses preserved scroll replays while a deliberate scroll handoff is active', () => {
const navigate = vi.fn();
let currentPath = '/proxmox/overview?type=app-container';
const scheduler = createRouteStateNavigateScheduler(navigate, () => currentPath);
markRouteStateDeliberateScroll();
scheduler.schedule('/proxmox/overview?type=app-container&resource=guest-1');
vi.runAllTimers();
expect(navigate).toHaveBeenCalledWith(
'/proxmox/overview?type=app-container&resource=guest-1',
ROUTE_STATE_REPLACE_OPTIONS,
);
expect(scrollToSpy).not.toHaveBeenCalled();
});
});