import type { Page, Request } from "@playwright/test"; /** Defer pre-navigation aborts only until a distinct document is confirmed. */ export function observeDocumentDepartures( page: Page, onFailure: (request: Request) => void, ): () => Promise { const identify = () => page.evaluate(() => performance.timeOrigin).catch(() => null); let currentDocument = identify(); const checks: Promise[] = []; page.on("framenavigated", (frame) => { if (frame === page.mainFrame()) currentDocument = identify(); }); const inFlight = new Set(); const departures: { request: Request; oldRequests: Set; failures: Request[]; response: boolean; committed: boolean; previousDocument: Promise; }[] = []; const finish = (request: Request) => { inFlight.delete(request); for (const departure of departures) departure.oldRequests.delete(request); }; page.on("request", (request) => { if (request.isNavigationRequest() && request.frame() === page.mainFrame()) { const redirected = departures.find( (departure) => departure.request === request.redirectedFrom(), ); if (redirected) redirected.request = request; else { if (departures.length >= 32) throw new Error("Browser document-departure limit exceeded"); departures.push({ request, oldRequests: new Set(inFlight), failures: [], response: false, committed: false, previousDocument: currentDocument, }); } } if (inFlight.size >= 512) throw new Error("Browser in-flight request limit exceeded"); inFlight.add(request); }); page.on("response", (response) => { const departure = departures.find( (candidate) => candidate.request === response.request(), ); if (departure && response.status() < 300) departure.response = true; }); page.on("domcontentloaded", () => { const departure = departures.at(-1); if (!departure?.response) return; // An older document can finish parsing while a replacement is pending. // Missing/destroyed contexts are ambiguous, never evidence of departure. const previous = departure.previousDocument; const next = identify(); checks.push( Promise.all([previous, next]).then(([before, after]) => { if (before !== null && after !== null && before !== after) { departure.committed = true; departure.failures.length = 0; } }), ); }); page.on("requestfinished", finish); page.on("requestfailed", (request) => { const departure = departures.find((candidate) => candidate.oldRequests.has(request), ); if ( departure && !request.isNavigationRequest() && request.failure()?.errorText === "net::ERR_ABORTED" ) { if (!departure.committed) departure.failures.push(request); } else onFailure(request); finish(request); }); return async () => { await Promise.all(checks); for (const departure of departures) for (const request of departure.failures) onFailure(request); }; }