Adds browser tests and fixes hydration of the 404 page

The prerendered 404 page is served for other URLs, so its dehydrated match id
differs and the router renders the catch-all's pending component first. Without
one that render was empty, which gave React error 418 and duplicate head tags.
The tests run the built output in a real browser under the production CSP.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-31 19:03:07 +01:00
co-authored by Claude Opus 5.5
parent 0c5d8b8f40
commit 8bf0000531
15 changed files with 1216 additions and 48 deletions
+136
View File
@@ -0,0 +1,136 @@
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;
});
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;
// 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,
expectNotFound = false,
prepare,
}: OpenOptions = {},
): Promise<OpenedPage> {
const context = await (
await launch()
).newContext({
javaScriptEnabled: javaScript,
viewport: { width, height },
});
contexts.add(context);
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: 15_000, interval: 100 });
+12
View File
@@ -0,0 +1,12 @@
import { existsSync } from 'node:fs';
import { join } from 'node:path';
import { clientDir } from './server.ts';
// De browsertests bouwen niets: zonder build testen ze een oude of lege map
export default function setup() {
if (!existsSync(join(clientDir, 'index.html'))) {
throw new Error(
`dist/client ontbreekt (${clientDir}). Draai eerst: pnpm build`,
);
}
}
+24
View File
@@ -0,0 +1,24 @@
import type { AddressInfo } from 'node:net';
import { resolve } from 'node:path';
import { startPreviewServer } from '../../config/previewServer.ts';
// De gebouwde site: `pnpm build` schrijft hem, de tests bouwen niets. Relatief
// aan de werkmap (web/), zoals `pnpm preview`; import.meta.url is in een
// jsdom-testbestand geen bestands-URL.
export const clientDir = resolve('dist/client');
// Dezelfde server als `pnpm preview`, met de productie-CSP en echte 404's,
// op een poort die het systeem kiest zodat tests elkaar niet in de weg zitten
export async function startServer() {
const server = await startPreviewServer(clientDir, 0);
const { port } = server.address() as AddressInfo;
return {
origin: `http://127.0.0.1:${port}`,
close: () =>
new Promise<void>((resolve, reject) => {
server.close((error) => (error ? reject(error) : resolve()));
// Open keep-alive-verbindingen van Chrome houden close() op
server.closeAllConnections();
}),
};
}