import { expect, test } from "./helpers/instrumentedTest"; import { getPanelMetrics, getPanelWithTriggerMetrics, } from "./helpers/popoverUtils"; import { applyReducedMotion, ensureTestAssets, failOnConsoleErrors, waitForRAF, } from "./helpers/uiTestUtils"; function assertWithinViewport(metrics: { rect: { top: number; left: number; right: number; bottom: number }; viewport: { width: number; height: number }; }) { const tolerance = 0.5; expect(metrics.rect.left).toBeGreaterThanOrEqual(-tolerance); expect(metrics.rect.top).toBeGreaterThanOrEqual(-tolerance); expect(metrics.rect.right).toBeLessThanOrEqual(metrics.viewport.width + tolerance); expect(metrics.rect.bottom).toBeLessThanOrEqual(metrics.viewport.height + tolerance); } test.describe("popover layout scenarios", () => { test.beforeEach(async ({ page }) => { await ensureTestAssets(page); await applyReducedMotion(page); failOnConsoleErrors(page); await page.goto("/docs/popover-scenarios.html", { waitUntil: "networkidle" }); }); // flaky: Popover fails to flip to top in restricted viewport (floating-ui issue?) test("keeps the bottom-right grid menu inside the viewport", async ({ page }) => { // Force a tall body with top padding to ensure there is space above for the popover to flip to await page.addStyleTag({ content: "body { padding-top: 1000px !important; min-height: 3000px !important; }" }); // Reduce viewport height to force the menu to flip to the top await page.setViewportSize({ width: 1280, height: 250 }); const trigger = page.locator('[data-test-trigger="grid-bottom-right"]'); // Scroll the element to the bottom edge of the viewport await trigger.evaluate((el) => el.scrollIntoView({ block: "end", inline: "nearest" })); // Use force: true to prevent Playwright from attempting to scroll further await trigger.click({ force: true }); const panel = page.locator('[data-test-panel="grid-bottom-right"]'); await expect(panel).toHaveAttribute("data-popover-state", "open"); const metrics = await getPanelMetrics(panel); assertWithinViewport(metrics); expect(metrics.state).toBe("open"); expect(metrics.placement.startsWith("top"), `Expected placement to start with 'top' but got '${metrics.placement}'`).toBeTruthy(); expect(metrics.popoverMaxWidth).toBe(metrics.tokenMaxWidth); expect(metrics.tokenMaxWidth.length).toBeGreaterThan(0); }); test("opens the video modal menu without overflowing", async ({ page }) => { await page.locator('[data-test-open-modal]').click(); await expect(page.locator('[data-test-modal]')).toBeVisible(); await page.locator('[data-test-trigger="modal-menu"]').click(); const panel = page.locator('[data-test-panel="modal-menu"]'); await expect(panel).toHaveAttribute("data-popover-state", "open"); const metrics = await getPanelMetrics(panel); assertWithinViewport(metrics); expect(metrics.state).toBe("open"); expect(metrics.placement.includes("bottom")).toBeTruthy(); expect(metrics.popoverMaxWidth).toBe(metrics.tokenMaxWidth); expect(metrics.tokenMaxWidth.length).toBeGreaterThan(0); }); test("keeps scroll container menus in view after scrolling", async ({ page }) => { const scrollRegion = page.locator('[data-test-scroll-region]'); await scrollRegion.evaluate((node) => { node.scrollTop = node.scrollHeight; }); await page.locator('[data-test-trigger="scroll-bottom"]').click(); const panel = page.locator('[data-test-panel="scroll-bottom"]'); await expect(panel).toHaveAttribute("data-popover-state", "open"); const metrics = await getPanelMetrics(panel); assertWithinViewport(metrics); expect(metrics.state).toBe("open"); expect(metrics.popoverMaxWidth).toBe(metrics.tokenMaxWidth); expect(metrics.tokenMaxWidth.length).toBeGreaterThan(0); }); test("stress tests popover triggers without console errors", async ({ page }) => { await page.locator('[data-test-open-modal]').click(); await expect(page.locator('[data-test-modal]')).toBeVisible(); const triggers = [ '[data-test-trigger="grid-bottom-right"]', '[data-test-trigger="modal-menu"]', '[data-test-trigger="scroll-bottom"]', ]; for (let pass = 0; pass < 4; pass += 1) { const scrollRegion = page.locator('[data-test-scroll-region]'); await scrollRegion.evaluate((node) => { node.scrollTop = node.scrollHeight; }); for (const selector of triggers) { // Use force click to bypass potential residual overlay interception, simulating aggressive user action await page.locator(selector).click({ force: true }); await waitForRAF(page); } // Close by clicking backdrop/body // Use force: true to bypass potential interception if we just want to signal a close await page.click("body", { force: true }); await waitForRAF(page); await expect(page.locator('[data-popover-state="open"]')).toHaveCount(0); } }); }); test.describe("popover demo alignments", () => { test.beforeEach(async ({ page }) => { await ensureTestAssets(page); await applyReducedMotion(page); failOnConsoleErrors(page); await page.goto("/views/dev/popover-demo.html", { waitUntil: "networkidle" }); }); test("aligns the video card menu with the trigger's right edge", async ({ page }) => { const trigger = page.locator("[data-demo-card-more]"); await trigger.click(); const panel = page.locator('[data-component="overlay-root"] [data-popover-state="open"]'); await expect(panel).toBeVisible(); const metrics = await getPanelWithTriggerMetrics(panel, trigger); assertWithinViewport(metrics); expect(metrics.state).toBe("open"); expect(metrics.placement).toBe("bottom-end"); expect(metrics.popoverMaxWidth).toBe(metrics.tokenMaxWidth); expect(metrics).toHaveProperty("popoverMaxWidth"); const tolerance = 1.5; expect(Math.abs(metrics.rect.right - metrics.triggerRect.right)).toBeLessThanOrEqual(tolerance); }); test("aligns the modal gear menu with the trigger's right edge", async ({ page }) => { await page.locator("[data-demo-open-modal]").click(); await expect(page.locator("[data-demo-modal]")) .toBeVisible({ timeout: 5000 }); const trigger = page.locator("[data-demo-modal-more]"); await trigger.click(); const panel = page.locator('[data-component="overlay-root"] [data-popover-state="open"]'); await expect(panel).toBeVisible(); const metrics = await getPanelWithTriggerMetrics(panel, trigger); assertWithinViewport(metrics); expect(metrics.state).toBe("open"); expect(metrics.placement).toBe("bottom-end"); expect(metrics.popoverMaxWidth).toBe(metrics.tokenMaxWidth); const tolerance = 1.5; expect(Math.abs(metrics.rect.right - metrics.triggerRect.right)).toBeLessThanOrEqual(tolerance); }); });