11// fallow-ignore-file code-duplication
2- import { afterAll , describe , expect , it , mock } from "bun:test" ;
2+ import { afterAll , describe , expect , it , mock , vi } from "bun:test" ;
33import { existsSync , mkdirSync , mkdtempSync , rmSync } from "node:fs" ;
44import { tmpdir } from "node:os" ;
55import { join } from "node:path" ;
@@ -26,6 +26,9 @@ let sessionWorkerEncodeEnabled = false;
2626let captureSessionMode : "drawelement" | "screenshot" = "drawelement" ;
2727let failPrepareCaptureSessionForReuse = false ;
2828let initializeSessionErrorMessage = "initialize failed" ;
29+ let hangDeferredDrawElementInit = false ;
30+ /** While set, opening a session waits for this promise instead of returning a fresh one. */
31+ let pendingOpen : Promise < unknown > | null = null ;
2932const browserConsoleBuffer = [ "[FrameCapture:ERROR] page.goto failed" ] ;
3033const closeCaptureSession = mock ( async ( ) => { } ) ;
3134const createdSessionConfigs : Array < { enableBrowserPool ?: boolean } > = [ ] ;
@@ -62,10 +65,12 @@ mock.module("@hyperframes/engine", () => ({
6265 return { buffer : Buffer . from ( "frame" ) , captureTimeMs : 1 } ;
6366 } ,
6467 closeCaptureSession,
65- completeDeferredDrawElementInit : async ( ) => { } ,
68+ completeDeferredDrawElementInit : ( ) =>
69+ hangDeferredDrawElementInit ? new Promise < void > ( ( ) => { } ) : Promise . resolve ( ) ,
6670 createCaptureSession : async ( ...args : unknown [ ] ) => {
6771 createdSessionConfigs . push ( args [ 4 ] as { enableBrowserPool ?: boolean } ) ;
6872 createdSessionHooks . push ( args [ 3 ] ) ;
73+ if ( pendingOpen ) return pendingOpen ;
6974 return {
7075 isInitialized : false ,
7176 browserConsoleBuffer,
@@ -451,6 +456,81 @@ describe("runCaptureSegmentedStage", () => {
451456 expect ( result ) . toEqual ( { success : false } ) ;
452457 } ) ;
453458
459+ /** Runs the stage on a fake clock, a second at a time, until it settles or 30 minutes pass. */
460+ const settleOnFakeClock = async ( run : Promise < unknown > ) => {
461+ const state = { done : false , error : undefined as unknown , elapsedMs : 0 } ;
462+ run . then (
463+ ( ) => ( state . done = true ) ,
464+ ( error : unknown ) => Object . assign ( state , { done : true , error } ) ,
465+ ) ;
466+ const flush = async ( ) => {
467+ for ( let i = 0 ; i < 200 ; i ++ ) await Promise . resolve ( ) ;
468+ } ;
469+ await flush ( ) ;
470+ while ( ! state . done && state . elapsedMs < 30 * 60_000 ) {
471+ vi . advanceTimersByTime ( 1_000 ) ;
472+ state . elapsedMs += 1_000 ;
473+ await flush ( ) ;
474+ }
475+ return state ;
476+ } ;
477+
478+ it ( "gives up on a deferred drawElement init that never finishes, within the session-init budget" , async ( ) => {
479+ hangDeferredDrawElementInit = true ;
480+ closeCaptureSession . mockClear ( ) ;
481+ const prev = process . env . HF_DE_STALL_MS ;
482+ delete process . env . HF_DE_STALL_MS ;
483+ vi . useFakeTimers ( ) ;
484+ try {
485+ const input = fakeStageInput ( { totalFrames : 3 } ) ;
486+ const state = await settleOnFakeClock (
487+ runCaptureSegmentedStage ( { ...input , segmentFrames : 3 } ) ,
488+ ) ;
489+ expect ( state . done ) . toBe ( true ) ;
490+ expect ( state . elapsedMs ) . toBeLessThanOrEqual ( 305_000 ) ;
491+ expect ( ( state . error as Error ) . message ) . toContain (
492+ "no frame progress for 300000ms (stuck at frame 0/3)" ,
493+ ) ;
494+ expect ( closeCaptureSession . mock . calls . map ( ( c ) => c [ 0 ] ) ) . toContain ( input . probeSession ) ;
495+ } finally {
496+ vi . useRealTimers ( ) ;
497+ hangDeferredDrawElementInit = false ;
498+ if ( prev !== undefined ) process . env . HF_DE_STALL_MS = prev ;
499+ }
500+ } ) ;
501+
502+ it ( "gives up on a session that never finishes opening, and closes it when it opens late" , async ( ) => {
503+ let openLate : ( session : unknown ) => void = ( ) => { } ;
504+ pendingOpen = new Promise ( ( resolve ) => ( openLate = resolve ) ) ;
505+ closeCaptureSession . mockClear ( ) ;
506+ const prev = process . env . HF_DE_STALL_MS ;
507+ delete process . env . HF_DE_STALL_MS ;
508+ vi . useFakeTimers ( ) ;
509+ try {
510+ const state = await settleOnFakeClock (
511+ runCaptureSegmentedStage ( {
512+ ...fakeStageInput ( { totalFrames : 3 } ) ,
513+ probeSession : undefined ,
514+ segmentFrames : 3 ,
515+ } ) ,
516+ ) ;
517+ expect ( state . done ) . toBe ( true ) ;
518+ expect ( state . elapsedMs ) . toBeLessThanOrEqual ( 305_000 ) ;
519+ expect ( ( state . error as Error ) . message ) . toContain (
520+ "no frame progress for 300000ms (stuck at frame 0/3 while opening the capture session)" ,
521+ ) ;
522+
523+ const late = { browserConsoleBuffer : [ ] } ;
524+ openLate ( late ) ;
525+ for ( let i = 0 ; i < 20 ; i ++ ) await Promise . resolve ( ) ;
526+ expect ( closeCaptureSession ) . toHaveBeenCalledWith ( late ) ;
527+ } finally {
528+ vi . useRealTimers ( ) ;
529+ pendingOpen = null ;
530+ if ( prev !== undefined ) process . env . HF_DE_STALL_MS = prev ;
531+ }
532+ } ) ;
533+
454534 it ( "returns success:false when the first encoder cannot spawn, and has closed the probe" , async ( ) => {
455535 const spawnEncoder = mock ( async ( ) => {
456536 throw new Error ( "ffmpeg missing" ) ;
0 commit comments