Files
hyperframes/packages/engine/src/services/frameCapture.test.ts
T
Miguel Ángel 73e65e2c78 fix(engine): a background image that never finishes decoding no longer stalls the frame (#6972)
* fix(engine): a background image that never finishes decoding no longer stalls the frame

* fix(engine): capture tolerates a page that returns no list of late background images

* fix(engine): a background decode timeout is reported at every caller, url redacted

* fix(engine): a relative background url keeps only its path in the decode timeout report
2026-11-04 20:41:50 +00:00

737 lines
28 KiB
TypeScript

import { describe, it, expect, vi } from "vitest";
import type { Protocol } from "puppeteer-core";
import { COMPOSITION_SOURCE_URL, SCENE_CALLBACK_ERROR_PREFIX } from "@hyperframes/core";
import type { CaptureSession } from "./frameCapture.js";
import type { SubTimelineWaitMemo } from "../types.js";
import {
buildZeroDurationDiagnostic,
pollHfReady,
captureFramesBatchPipelined,
captureFrameToBufferPipelined,
classifyConsoleScriptError,
classifyConsoleScriptFailure,
classifyPageError,
DrawElementVerificationError,
formatHttpErrorDiagnostic,
formatConsoleDiagnostic,
formatNavigationFailureDiagnostic,
formatNavigationStartDiagnostic,
formatRequestFailureDiagnostic,
HF_READY_DIAGNOSTIC_EXPR,
initializeSession,
getDrawElementVerificationDetails,
isFontResourceError,
isDrawElementVerificationError,
sanitizeDiagnosticUrl,
VfxFailureError,
shouldIgnoreRequestFailureDiagnostic,
} from "./frameCapture.js";
describe("classifyConsoleScriptFailure", () => {
it("promotes Chromium's blocked subresource-integrity diagnostic", () => {
expect(
classifyConsoleScriptFailure(
"error",
"Failed to find a valid digest in the 'integrity' attribute for resource 'http://127.0.0.1:4173/_ext/vendor/gsap.js' with computed SHA-384 integrity 'abc'. The resource has been blocked.",
),
).toBe("runtime-error:subresource-integrity");
});
it("ignores non-error and unrelated integrity messages", () => {
expect(
classifyConsoleScriptFailure(
"warning",
"Failed to find a valid digest in the 'integrity' attribute. The resource has been blocked.",
),
).toBeNull();
expect(classifyConsoleScriptFailure("error", "Integrity metadata is present.")).toBeNull();
});
// A thrown composition script may still register its timeline, so it is a page error, not a load failure.
it("leaves a composition script's logged throw to classifyConsoleScriptError", () => {
const logged = "[HyperFrames] composition script error: scene TypeError: x";
expect(classifyConsoleScriptFailure("error", logged)).toBeNull();
expect(classifyConsoleScriptError("error", `${logged}\r\n at scene.js:1`)).toBe(
"runtime-error:scene TypeError: x",
);
expect(classifyConsoleScriptError("warning", logged)).toBeNull();
});
});
describe("classifyPageError", () => {
const server = "http://localhost:4100";
const doc = `${server}/index.html`;
// Shapes as Chromium 152 reports them through Runtime.exceptionThrown.
const thrown = (
description: string | undefined,
url: string,
frames: string[],
value?: string,
): Protocol.Runtime.ExceptionDetails => ({
exceptionId: 1,
text: "Uncaught",
lineNumber: 0,
columnNumber: 0,
url,
exception: { type: description ? "object" : "string", description, value },
stackTrace: {
callFrames: frames.map((frameUrl) => ({ url: frameUrl }) as Protocol.Runtime.CallFrame),
},
});
const comp = `${server}/comp.js`;
const served = new Set([comp]);
const named = COMPOSITION_SOURCE_URL;
it("records an error thrown by a script file the page loaded from the server, by its first line", () => {
const error =
"TypeError: Cannot read properties of null (reading 'timeline')\n at build (comp.js:1:37)";
expect(classifyPageError(thrown(error, comp, [comp]), served)).toBe(
"runtime-error:TypeError: Cannot read properties of null (reading 'timeline')",
);
});
it("records a syntax error and a thrown string, which carry no error stack", () => {
const syntax = thrown("SyntaxError: Unexpected token ';'", comp, []);
const plain = thrown(undefined, named, [named], "plain string");
expect(classifyPageError(syntax, served)).toBe(
"runtime-error:SyntaxError: Unexpected token ';'",
);
expect(classifyPageError(plain, served)).toBe("runtime-error:plain string");
});
it("records the composition's inline code, named by the render compiler, and a library it called", () => {
const lib = "https://cdn.example/lib.js";
expect(classifyPageError(thrown("TypeError: x", named, [named]), served)).toBe(
"runtime-error:TypeError: x",
);
expect(classifyPageError(thrown("TypeError: x", lib, [lib, named]), served)).toBe(
"runtime-error:TypeError: x",
);
});
// A widget's failed img.decode() and the composition's failed r.json() report the same shape,
// naming the current document: after a hash change, a replaceState, or inside an iframe.
it.each([doc, `${doc}#consent`, `${server}/frame.html`])(
"ignores a frameless rejection naming %s",
(url) => {
const decode = thrown("EncodingError: The source image cannot be decoded.", url, []);
expect(classifyPageError({ ...decode, text: "Uncaught (in promise)" }, served)).toBeNull();
},
);
// An inline handler a widget inserts reports the current document, which the widget can move anywhere on the server.
it.each([doc, `${doc}#c`, `${server}/elsewhere/page?q=1`])(
"ignores an inline handler reporting the document at %s",
(url) => {
expect(classifyPageError(thrown("TypeError: x", url, [url]), served)).toBeNull();
},
);
// Chromium names no URL for eval'd or script-inserted code, so it has no owner unless a named frame calls it.
it("ignores unnamed code a widget evals or inserts, even when the widget's frame is on the stack", () => {
const widget = "http://127.0.0.1:4200/w.js";
expect(classifyPageError(thrown("TypeError: x", "", [""]), served)).toBeNull();
expect(classifyPageError(thrown("TypeError: x", "", ["", widget]), served)).toBeNull();
});
it("ignores an error whose frames are all named off the page: an inlined CDN script and the runtime", () => {
const cdn = "http://127.0.0.1:4200/sync.js";
expect(
classifyPageError(thrown("Error: w", cdn, [cdn, "hyperframes://injected/0"]), served),
).toBeNull();
});
it("records a rejection that carries the composition's frames", () => {
const rejected = {
...thrown("Error: init failed", comp, [comp]),
text: "Uncaught (in promise)",
};
expect(classifyPageError(rejected, served)).toBe("runtime-error:Error: init failed");
});
it("ignores a frameless error naming the document itself", () => {
expect(
classifyPageError(thrown("SyntaxError: Unexpected token ';'", doc, []), served),
).toBeNull();
});
it("ignores errors from other origins and the benign play/pause race", () => {
const widget = "http://127.0.0.1:4100/widget.js";
const abort =
"AbortError: The play() request was interrupted by a call to pause(). https://goo.gl/LdLk22";
expect(classifyPageError(thrown("Error: widget failed", widget, [widget]), served)).toBeNull();
expect(classifyPageError(thrown(abort, named, [named]), served)).toBeNull();
});
// initializeSession registers its listeners before the incomplete fake session makes it throw.
async function listenedSession(memo: SubTimelineWaitMemo = {}) {
const runtimeListeners = new Map<string, (event: unknown) => void>();
const pageListeners = new Map<string, (event: unknown) => void>();
const listen =
(listeners: typeof pageListeners) => (event: string, listener: (event: unknown) => void) =>
listeners.set(event, listener);
const client = { on: listen(runtimeListeners), send: async () => ({}) };
const page = { on: listen(pageListeners), createCDPSession: async () => client };
const session = {
page,
serverUrl: server,
scriptLoadFailures: [] as string[],
pageErrors: [] as string[],
warnings: [] as { code: string }[],
browserConsoleBuffer: [],
subTimelineWaitMemo: memo,
} as unknown as CaptureSession;
await initializeSession(session).catch(() => {});
return { session, pageListeners, runtimeListeners };
}
it("keeps browser diagnostics on stderr and in the session buffer", async () => {
const stdout = vi.spyOn(console, "log").mockImplementation(() => {});
const stderr = vi.spyOn(console, "error").mockImplementation(() => {});
try {
const { session, pageListeners } = await listenedSession();
const emit = (type: string, text: string, url = "") =>
pageListeners.get("console")?.({
type: () => type,
text: () => text,
location: () => ({ url }),
});
emit("info", "[hyperframes] render runtime fps");
emit("warn", "GPU readback warning");
emit("error", "[HyperFrames] composition script error: scene TypeError: x");
emit("error", "Failed to load resource", "https://fonts.gstatic.com/font.woff2");
expect(stderr.mock.calls).toEqual([
["[HyperFrames] render runtime fps"],
["[Browser:WARN] GPU readback warning"],
["[Browser:ERROR] [HyperFrames] composition script error: scene TypeError: x"],
]);
expect(stdout).not.toHaveBeenCalled();
expect(session.browserConsoleBuffer).toEqual([
"[HyperFrames] render runtime fps",
"[Browser:WARN] GPU readback warning",
"[Browser:ERROR] [HyperFrames] composition script error: scene TypeError: x",
"[Browser] Failed to load resource",
]);
expect(session.pageErrors).toEqual(["runtime-error:scene TypeError: x"]);
} finally {
stdout.mockRestore();
stderr.mockRestore();
}
});
it("records the page's uncaught errors from scripts it loaded from the server", async () => {
const { session, pageListeners, runtimeListeners } = await listenedSession();
const loaded = (url: string, resourceType: string) => ({
status: () => 200,
url: () => url,
request: () => ({ resourceType: () => resourceType }),
});
pageListeners.get("response")?.(loaded(comp, "script"));
pageListeners.get("response")?.(loaded(`${server}/data.js`, "fetch"));
const exception = (url: string) =>
runtimeListeners.get("Runtime.exceptionThrown")?.({
exceptionDetails: thrown(`ReferenceError: ${url}`, url, [url]),
});
for (const url of [comp, comp, `${server}/data.js`, doc]) exception(url);
expect(session.pageErrors).toEqual([`runtime-error:ReferenceError: ${comp}`]);
expect(session.scriptLoadFailures).toEqual([]);
});
it("records the first VFX error to stop the render, and a scene's logged throw as a page error", async () => {
const { session, pageListeners } = await listenedSession();
const logged = (detail: string) =>
pageListeners.get("console")?.({
type: () => "error",
text: () => `[HyperFrames] composition script error: ${detail}`,
location: () => ({}),
});
logged("vfx: #host: unknown effect");
logged("vfx: #host: WebGL context lost.");
logged("vfx-frame: #host: no paint arrived");
logged("scene TypeError: x");
expect(session.vfxFailure).toBe("runtime-error:vfx: #host: unknown effect");
expect(session.warnings.map((warning) => warning.code)).toEqual(["vfx_failure"]);
expect(session.pageErrors).toEqual([
"runtime-error:vfx-frame: #host: no paint arrived",
"runtime-error:scene TypeError: x",
]);
});
it("logs a scene callback error once per render, and never as a page error", async () => {
const memo: SubTimelineWaitMemo = {};
const sessions = [await listenedSession(memo), await listenedSession(memo)];
const log = vi.spyOn(console, "error").mockImplementation(() => {});
const text = `${SCENE_CALLBACK_ERROR_PREFIX} "scene" TypeError: x`;
for (const { pageListeners } of sessions) {
for (let i = 0; i < 2; i++) {
pageListeners.get("console")?.({
type: () => "warn",
text: () => text,
location: () => ({}),
});
}
}
const logged = log.mock.calls.filter(([line]) => String(line).includes('"scene" TypeError: x'));
expect(logged).toHaveLength(1);
for (const { session } of sessions) expect(session.pageErrors).toEqual([]);
log.mockRestore();
});
it("refuses to capture another frame once a VFX chain has failed", async () => {
const session = {
isInitialized: true,
vfxFailure: "runtime-error:vfx: #host: unknown effect",
options: { fps: { num: 30, den: 1 } },
} as unknown as CaptureSession;
await expect(captureFrameToBufferPipelined(session, 0, 0)).rejects.toBeInstanceOf(
VfxFailureError,
);
await expect(captureFramesBatchPipelined(session, [0], [0])).rejects.toBeInstanceOf(
VfxFailureError,
);
});
});
describe("isFontResourceError", () => {
it("matches Google Fonts CSS load failures via location.url", () => {
expect(
isFontResourceError(
"error",
"Failed to load resource: net::ERR_FAILED",
"https://fonts.googleapis.com/css2?family=Inter",
),
).toBe(true);
});
it("matches gstatic font binaries via location.url", () => {
expect(
isFontResourceError(
"error",
"Failed to load resource: the server responded with a status of 404 (Not Found)",
"https://fonts.gstatic.com/s/inter/v12/foo.woff2",
),
).toBe(true);
});
it("matches self-hosted woff2 failures", () => {
expect(
isFontResourceError(
"error",
"Failed to load resource: net::ERR_CONNECTION_REFUSED",
"http://localhost:9999/font.woff2",
),
).toBe(true);
});
it("matches .ttf and .otf URLs", () => {
expect(
isFontResourceError("error", "Failed to load resource: 404", "http://example.com/a.ttf"),
).toBe(true);
expect(
isFontResourceError("error", "Failed to load resource: 404", "http://example.com/b.otf"),
).toBe(true);
});
it("does NOT match non-font resources (images, scripts, videos)", () => {
expect(
isFontResourceError("error", "Failed to load resource: 404", "https://example.com/img.png"),
).toBe(false);
expect(
isFontResourceError(
"error",
"Failed to load resource: 404",
"https://cdn.example.com/bundle.js",
),
).toBe(false);
expect(
isFontResourceError("error", "Failed to load resource: 404", "https://example.com/video.mp4"),
).toBe(false);
});
it("does NOT match when location.url is missing and text has no URL (safe default)", () => {
expect(isFontResourceError("error", "Failed to load resource: 404", "")).toBe(false);
});
it("still matches when URL appears in text (older Chrome formats)", () => {
expect(
isFontResourceError(
"error",
"Failed to load resource: https://fonts.googleapis.com/... 404",
"",
),
).toBe(true);
});
it("does NOT match non-error console messages", () => {
expect(
isFontResourceError(
"warn",
"Failed to load resource: 404",
"https://fonts.googleapis.com/css2",
),
).toBe(false);
expect(
isFontResourceError(
"info",
"Failed to load resource: 404",
"https://fonts.googleapis.com/css2",
),
).toBe(false);
});
it("does NOT match unrelated error messages", () => {
expect(isFontResourceError("error", "Uncaught ReferenceError: x is not defined", "")).toBe(
false,
);
expect(
isFontResourceError("error", "Some other error", "https://fonts.googleapis.com/css2"),
).toBe(false);
});
it("is case-insensitive for URL matching", () => {
expect(
isFontResourceError(
"error",
"Failed to load resource: 404",
"https://FONTS.GOOGLEAPIS.COM/css2",
),
).toBe(true);
expect(
isFontResourceError("error", "Failed to load resource: 404", "http://example.com/FONT.WOFF2"),
).toBe(true);
});
});
describe("formatConsoleDiagnostic", () => {
it("surfaces HyperFrames page logs with a dedicated host prefix", () => {
expect(
formatConsoleDiagnostic("info", '[hyperframes] render runtime fps {"canonicalFps":30}', ""),
).toEqual({
text: '[HyperFrames] render runtime fps {"canonicalFps":30}',
suppressHostLog: false,
});
});
it("keeps font load errors in diagnostics but suppresses host log noise", () => {
expect(
formatConsoleDiagnostic(
"error",
"Failed to load resource: net::ERR_FAILED",
"https://fonts.googleapis.com/css2?family=Inter",
),
).toEqual({
text: "[Browser] Failed to load resource: net::ERR_FAILED",
suppressHostLog: true,
});
});
it("preserves existing browser prefixes for generic logs", () => {
expect(formatConsoleDiagnostic("warn", "careful", "")).toEqual({
text: "[Browser:WARN] careful",
suppressHostLog: false,
});
});
});
describe("navigation diagnostics", () => {
it("redacts credentials, query strings, and fragments from diagnostic URLs", () => {
expect(
sanitizeDiagnosticUrl("https://user:pass@example.com/assets/video.mp4?token=secret#frag"),
).toBe("https://example.com/assets/video.mp4");
});
it("redacts data and blob URLs", () => {
expect(sanitizeDiagnosticUrl("data:image/png;base64,abc123")).toBe("data:<redacted>");
expect(sanitizeDiagnosticUrl("blob:https://example.com/abc123")).toBe("blob:<redacted>");
});
it("redacts query strings from relative URLs", () => {
expect(sanitizeDiagnosticUrl("/relative/path.png?token=secret#frag")).toBe(
"/relative/path.png",
);
});
it("keeps only the path of bare and dot-relative URLs", () => {
expect(sanitizeDiagnosticUrl("./assets/bg.webp?example=REDACT_ME#fragment")).toBe(
"/assets/bg.webp",
);
expect(sanitizeDiagnosticUrl("assets/bg.webp?example=REDACT_ME")).toBe("/assets/bg.webp");
expect(sanitizeDiagnosticUrl("//user:pw@cdn.test/bg.jpg?t=1")).toBe("/bg.jpg");
});
it("formats page.goto failures with mode, timeout, elapsed time, and sanitized URL", () => {
const diagnostic = formatNavigationFailureDiagnostic({
captureMode: "screenshot",
url: "http://127.0.0.1:4173/index.html?claim_token=secret",
timeoutMs: 60_000,
elapsedMs: 60_123,
error: new Error("Navigation timeout of 60000 ms exceeded"),
});
expect(diagnostic).toContain("[FrameCapture:ERROR] page.goto failed");
expect(diagnostic).toContain("mode=screenshot");
expect(diagnostic).toContain("timeoutMs=60000");
expect(diagnostic).toContain("elapsedMs=60123");
expect(diagnostic).toContain("url=http://127.0.0.1:4173/index.html");
expect(diagnostic).not.toContain("claim_token");
});
it("formats page.goto starts with mode, timeout, and sanitized URL", () => {
const diagnostic = formatNavigationStartDiagnostic({
captureMode: "screenshot",
url: "http://127.0.0.1:4173/index.html?claim_token=secret",
timeoutMs: 60_000,
});
expect(diagnostic).toContain("[FrameCapture:NAV] page.goto start");
expect(diagnostic).toContain("mode=screenshot");
expect(diagnostic).toContain("timeoutMs=60000");
expect(diagnostic).toContain("url=http://127.0.0.1:4173/index.html");
expect(diagnostic).not.toContain("claim_token");
});
it("formats request and HTTP failures with sanitized URLs", () => {
expect(
formatRequestFailureDiagnostic({
method: "GET",
resourceType: "media",
url: "https://cdn.example.com/video.mp4?token=secret",
failureText: "net::ERR_FAILED",
}),
).toBe(
"[Browser:REQUESTFAILED] GET https://cdn.example.com/video.mp4 resource=media error=net::ERR_FAILED",
);
expect(
formatHttpErrorDiagnostic({
method: "GET",
resourceType: "image",
url: "https://cdn.example.com/frame.png?token=secret",
status: 403,
statusText: "Forbidden",
}),
).toBe("[Browser:HTTP403] GET https://cdn.example.com/frame.png resource=image Forbidden");
});
it("ignores benign media aborts without hiding real request failures", () => {
expect(
shouldIgnoreRequestFailureDiagnostic({
resourceType: "media",
url: "http://127.0.0.1:4173/assets/video.mp4",
failureText: "net::ERR_ABORTED",
}),
).toBe(true);
expect(
shouldIgnoreRequestFailureDiagnostic({
resourceType: "other",
url: "http://127.0.0.1:4173/assets/audio.oga?cache=1",
failureText: "net::ERR_ABORTED",
}),
).toBe(true);
expect(
shouldIgnoreRequestFailureDiagnostic({
resourceType: "media",
url: "http://127.0.0.1:4173/assets/video.mp4",
failureText: "net::ERR_FAILED",
}),
).toBe(false);
expect(
shouldIgnoreRequestFailureDiagnostic({
resourceType: "script",
url: "http://127.0.0.1:4173/assets/app.js",
failureText: "net::ERR_ABORTED",
}),
).toBe(false);
});
});
describe("DrawElementVerificationError details", () => {
it("carries frameIndex/failedDb/verifyThresholdDb when provided", () => {
const err = new DrawElementVerificationError("drawElement self-verify failed at frame 649", {
kind: "psnr",
frameIndex: 649,
failedDb: 28.4,
verifyThresholdDb: 32,
});
expect(isDrawElementVerificationError(err)).toBe(true);
expect(getDrawElementVerificationDetails(err)).toEqual({
kind: "psnr",
frameIndex: 649,
failedDb: 28.4,
verifyThresholdDb: 32,
});
});
it("omits fields that weren't supplied (blank-frame throws have no dB)", () => {
const err = new DrawElementVerificationError("blank drawElement frame 12", {
kind: "blank",
frameIndex: 12,
});
expect(getDrawElementVerificationDetails(err)).toEqual({ kind: "blank", frameIndex: 12 });
});
it("returns undefined for a non-verification error", () => {
expect(getDrawElementVerificationDetails(new Error("boring"))).toBeUndefined();
});
it("finds details through a wrapping cause chain (producer's CaptureStageError)", () => {
const inner = new DrawElementVerificationError("psnr breach", {
kind: "psnr",
frameIndex: 5,
failedDb: 12.1,
});
const wrapper = new Error("capture stage failed", { cause: inner });
expect(isDrawElementVerificationError(wrapper)).toBe(true);
expect(getDrawElementVerificationDetails(wrapper)).toEqual({
kind: "psnr",
frameIndex: 5,
failedDb: 12.1,
});
});
it("carries kind='blank'/'psnr' as a structural field, not derived from message text", () => {
const blankErr = new DrawElementVerificationError("blank drawElement frame 12", {
kind: "blank",
frameIndex: 12,
});
const psnrErr = new DrawElementVerificationError(
"drawElement self-verify failed at frame 649",
{ kind: "psnr", frameIndex: 649, failedDb: 28.4, verifyThresholdDb: 32 },
);
expect(getDrawElementVerificationDetails(blankErr)?.kind).toBe("blank");
expect(getDrawElementVerificationDetails(psnrErr)?.kind).toBe("psnr");
});
it("kind survives even when the message text disagrees with (or omits) the word psnr/blank", () => {
// A reworded message that says neither "blank" nor "psnr" — a regex over
// message text would have no signal here; the structural kind must still
// report correctly.
const reworded = new DrawElementVerificationError("frame 12 failed verification", {
kind: "blank",
frameIndex: 12,
});
expect(getDrawElementVerificationDetails(reworded)?.kind).toBe("blank");
// Adversarial: a psnr failure whose message happens to mention "blank"
// (e.g. quoting a neighboring log line) — the structural kind must not
// flip just because the substring "blank" appears in the text.
const adversarial = new DrawElementVerificationError(
"drawElement self-verify failed at frame 5 (previous frame was blank-guard-accepted)",
{ kind: "psnr", frameIndex: 5, failedDb: 12.1, verifyThresholdDb: 32 },
);
expect(getDrawElementVerificationDetails(adversarial)?.kind).toBe("psnr");
});
});
describe("pollHfReady", () => {
it("fails at once with the runtime's start-up error instead of waiting out the timeout", async () => {
const startupError = "HyperFrames runtime failed: TypeError: boom";
const page = {
evaluate: async (expr: unknown) =>
String(expr).includes("__hfStartupError") ? startupError : false,
} as unknown as Parameters<typeof pollHfReady>[0];
await expect(pollHfReady(page, 60_000)).rejects.toThrow(startupError);
});
});
describe("buildZeroDurationDiagnostic", () => {
const baseDiag = {
renderReady: false,
hasHf: true,
hasSeek: true,
hasPlayer: true,
duration: 0,
hasTimeline: true,
declaredDuration: 6,
pendingBuildReadyKeys: [] as string[],
rejectedBuildReadyKeys: [] as string[],
};
it("names the stuck buildReady key instead of blaming GSAP/data-duration", () => {
const message = buildZeroDurationDiagnostic({
...baseDiag,
pendingBuildReadyKeys: ["heavy-mesh"],
});
expect(message).toContain("window.__hf.buildReady never resolved for: heavy-mesh");
});
it("lists every stuck key when more than one is pending", () => {
const message = buildZeroDurationDiagnostic({
...baseDiag,
pendingBuildReadyKeys: ["heavy-mesh", "shader-warmup"],
});
expect(message).toContain(
"window.__hf.buildReady never resolved for: heavy-mesh, shader-warmup",
);
});
it("omits the buildReady hint entirely when nothing is pending or rejected", () => {
const message = buildZeroDurationDiagnostic(baseDiag);
expect(message).not.toContain("buildReady");
});
it("names a rejected buildReady key separately from a pending one", () => {
const message = buildZeroDurationDiagnostic({
...baseDiag,
pendingBuildReadyKeys: ["heavy-mesh"],
rejectedBuildReadyKeys: ["shader-warmup"],
});
expect(message).toContain("window.__hf.buildReady never resolved for: heavy-mesh");
expect(message).toContain("window.__hf.buildReady rejected for: shader-warmup");
});
});
describe("HF_READY_DIAGNOSTIC_EXPR (evaluated as real JS, not via a fake fixture)", () => {
// The expression is a Puppeteer page.evaluate string, never executed by
// any other test. Running it here through `new Function` against a fake
// window/document exercises its actual settle/reject logic in-process.
async function runDiagnosticExpr(buildReady: Record<string, unknown>): Promise<{
pendingBuildReadyKeys: string[];
rejectedBuildReadyKeys: string[];
}> {
const fakeWindow = {
__hf: { seek: () => {}, duration: 0, buildReady },
__player: {},
__renderReady: false,
__timelines: {},
};
const fakeDocument = { querySelector: () => null };
const run = new Function("window", "document", `return ${HF_READY_DIAGNOSTIC_EXPR}`) as (
win: unknown,
doc: unknown,
) => Promise<{
pendingBuildReadyKeys: string[];
rejectedBuildReadyKeys: string[];
}>;
return run(fakeWindow, fakeDocument);
}
it("does not reject the whole diagnostic when a buildReady entry rejects", async () => {
const result = await runDiagnosticExpr({ heavy: Promise.reject(new Error("boom")) });
expect(result.rejectedBuildReadyKeys).toEqual(["heavy"]);
expect(result.pendingBuildReadyKeys).toEqual([]);
});
it("reports a settled non-native thenable as resolved, not pending", async () => {
const settledThenable = { then: (res: (v: unknown) => void) => res(1) };
const result = await runDiagnosticExpr({ heavy: settledThenable });
expect(result.pendingBuildReadyKeys).toEqual([]);
expect(result.rejectedBuildReadyKeys).toEqual([]);
});
it("reports a genuinely pending promise as pending", async () => {
const result = await runDiagnosticExpr({ heavy: new Promise(() => {}) });
expect(result.pendingBuildReadyKeys).toEqual(["heavy"]);
expect(result.rejectedBuildReadyKeys).toEqual([]);
});
it("returns empty arrays for a composition with no buildReady registrations", async () => {
const result = await runDiagnosticExpr({});
expect(result.pendingBuildReadyKeys).toEqual([]);
expect(result.rejectedBuildReadyKeys).toEqual([]);
});
});