Files
AndreaSlopFotografie/web/e2e/support/browser.ts
T
SluijsensandClaude Opus 5.5 2006fa01d9 Removes a duplicate from the upload script and its backups
The script body had been saved twice, so a production upload would have run
twice and left web.config backups on the host. Browser tests also get longer
limits on the slow CI runner; the page behaves the same.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 23:47:56 +01:00

151 lines
5.1 KiB
TypeScript

import {
chromium,
type Browser,
type BrowserContext,
type Page,
} from 'playwright-core';
import { afterAll, afterEach, expect } from 'vitest';
// Eén Chrome per testbestand, een eigen context (cookies, JavaScript aan of
// uit) per pagina. Zonder CHROME_PATH zoekt Playwright het geïnstalleerde Chrome.
let browser: Promise<Browser> | undefined;
const contexts = new Set<BrowserContext>();
// --no-sandbox en --disable-dev-shm-usage zijn nodig in CI. De Lighthouse-flags
// bevatten ook --headless=new; Playwright zet headless zelf.
const extraArgs = (process.env.LIGHTHOUSE_CHROME_FLAGS ?? '')
.split(/\s+/)
.filter((flag) => flag && !flag.startsWith('--headless'));
function launch() {
browser ??= chromium.launch({
...(process.env.CHROME_PATH
? { executablePath: process.env.CHROME_PATH }
: { channel: 'chrome' as const }),
args: extraArgs,
});
return browser;
}
afterEach(async () => {
await Promise.all([...contexts].map((context) => context.close()));
contexts.clear();
});
afterAll(async () => {
await (await browser)?.close();
browser = undefined;
});
// Op de CI-runner zijn de wachttijden van de browsertests 3 tot 6 keer zo
// lang als lokaal (zie testTimeout in vitest.e2e.config.ts)
export const inCi = Boolean(process.env.CI);
const CI_TIMEOUT = 90_000;
export interface OpenedPage {
page: Page;
status: number;
// Console-fouten en -waarschuwingen en niet-afgevangen fouten van de pagina
messages: string[];
// securitypolicyviolation-events: wat de CSP blokkeert
violations: string[];
}
export interface OpenOptions {
javaScript?: boolean;
width?: number;
height?: number;
// prefers-reduced-motion: reduce, voor de tests van Reveal
reducedMotion?: 'reduce';
// Een onbekende URL krijgt van de server bewust status 404 (BR-SRV-05).
// Chrome meldt dat voor het document zelf als console-fout. Alleen die ene
// melding wordt genegeerd; elke andere fout, ook een 404 voor een bestand
// of een hydratatiefout, blijft staan.
expectNotFound?: boolean;
// Voor de navigatie: bijvoorbeeld een request vertragen of vervangen
prepare?: (page: Page) => Promise<void>;
}
const NAVIGATION_404 =
'Failed to load resource: the server responded with a status of 404 (Not Found)';
// Opent de pagina en verzamelt alles wat de tests moeten kunnen aanwijzen. De
// luisteraars staan er al voor de navigatie, anders mist een test de fouten
// van de eerste render.
export async function openPage(
url: string,
{
javaScript = true,
width = 1280,
height = 800,
reducedMotion,
expectNotFound = false,
prepare,
}: OpenOptions = {},
): Promise<OpenedPage> {
const context = await (
await launch()
).newContext({
javaScriptEnabled: javaScript,
viewport: { width, height },
reducedMotion,
});
contexts.add(context);
// Playwright wacht standaard 30 s op een navigatie of een voorwaarde. Op de
// CI-runner (Raspberry Pi) duurde het laden van een pagina met foto's of
// de hydratatie daar soms langer (CI-run 598: goto en waitForHydration
// op 30 s afgebroken). Lokaal blijft 30 s.
if (inCi) context.setDefaultTimeout(CI_TIMEOUT);
const page = await context.newPage();
const messages: string[] = [];
const violations: string[] = [];
page.on('console', (message) => {
if (message.type() !== 'error' && message.type() !== 'warning') return;
if (
expectNotFound &&
message.text() === NAVIGATION_404 &&
message.location().url === url
) {
return;
}
messages.push(`${message.type()}: ${message.text()}`);
});
page.on('pageerror', (error) =>
messages.push(`pageerror: ${error.message}`),
);
await page.exposeFunction('reportViolation', (violation: string) =>
violations.push(violation),
);
await page.addInitScript(() => {
document.addEventListener('securitypolicyviolation', (event) => {
(
window as unknown as {
reportViolation: (violation: string) => void;
}
).reportViolation(
`${event.violatedDirective} blokkeerde ${event.blockedURI}`,
);
});
});
await prepare?.(page);
const response = await page.goto(url, { waitUntil: 'load' });
return { page, status: response?.status() ?? 0, messages, violations };
}
// De pagina is gehydrateerd als de e-mailplaceholders zijn ingevuld
// (BR-MAIL-02: er staat alleen een placeholder tot de hydratatie klaar is).
// Een hydratatiefout zou al eerder in `messages` staan.
export async function waitForHydration(page: Page) {
await page.waitForFunction(
() => !document.querySelector('[data-email-pending]'),
);
}
// Vitest kent de wachtende matchers van Playwright niet; expect.poll herhaalt
// de vraag aan de pagina tot het antwoord klopt of de tijd om is.
export const eventually = <T>(read: () => Promise<T>) =>
expect.poll(read, { timeout: inCi ? CI_TIMEOUT : 15_000, interval: 100 });