import { fileURLToPath } from "node:url"; import { defineConfig, devices } from "@playwright/test"; import { LOCAL_BUILD_IDENTITY } from "./scripts/lib/build-environment.ts"; import { reservePort, RUN_OUTPUT_ROOT_VARIABLE, TEST_PORT_VARIABLES, testRunPath, testRunRoot, } from "./scripts/lib/run-isolation.ts"; // 1105/12-04. Under TEST_RUN_ID the results, report and build are the run's // own (.tmp/runs//); the goldens in snapshotDir are shared and only read. // The preview listens on a free port (TEST_VISUAL_PORT pins one); it shared // 4174 with the capability dev server. const dist = testRunPath("dist"); const port = await reservePort(TEST_PORT_VARIABLES.visual); const origin = `http://127.0.0.1:${port}`; export default defineConfig({ testDir: "./tests/visual", forbidOnly: true, snapshotDir: "./tests/visual/__snapshots__", outputDir: testRunPath("artifacts/tests/visual/results"), reporter: [ ["list"], [ "html", { outputFolder: testRunPath("artifacts/tests/visual/report"), open: "never" }, ], ["junit", { outputFile: testRunPath("artifacts/tests/visual/results.xml") }], ], expect: { toHaveScreenshot: { animations: "disabled", caret: "hide", // 11-03. An absolute count, not a share of the image: 0.2% allowed // 2,592 px on the wide shell and let the 1,146 px UI-04 regression // pass. With fonts and raster settings pinned (11-02), a clean build // differs by 0 px, so this only covers stray anti-aliasing. maxDiffPixels: 50, scale: "css", }, }, use: { ...devices["Desktop Chrome"], baseURL: origin, colorScheme: "light", locale: "en-US", trace: "retain-on-failure", launchOptions: { // 11-02. Chromium sees only the fonts the goldens were captured with, // whatever the host or an outer FONTCONFIG_FILE says. The // `visual-fonts` project checks them before any screenshot. env: { ...process.env, FONTCONFIG_FILE: fileURLToPath( new URL("./tests/visual/fonts.conf", import.meta.url), ), }, }, }, webServer: { // The home page and the platform overview print the build and release // identity. CI sets VITE_BUILD_ID, VITE_COMMIT_SHA and RELEASE_ID for the // whole workflow, so its build drew other text than the goldens and every // CI run failed here. The goldens are the template's shape, captured with // the local identity. // 1103/11-08: CI too, or the build is checked as a release build. env: { ...LOCAL_BUILD_IDENTITY, [RUN_OUTPUT_ROOT_VARIABLE]: testRunRoot() }, command: `corepack pnpm build && corepack pnpm preview --host 127.0.0.1 --port ${port} --strictPort --outDir ${dist}`, url: origin, reuseExistingServer: false, }, projects: [ { name: "visual-fonts", testMatch: /fonts\.setup\.ts$/ }, { name: "chromium-visual", dependencies: ["visual-fonts"] }, ], });