'use strict'; const fs = require('fs'); const path = require('path'); const { JSDOM } = require('jsdom'); function flushAsyncWork (window, rounds = 6) { let chain = Promise.resolve(); for (let i = 0; i < rounds; i++) { chain = chain.then(() => new Promise((resolve) => window.setTimeout(resolve, 0))); } return chain; } function buildPlayerHarness (window, opts = {}) { const registeredComponents = new Map(); const autoReady = opts.autoReady !== false; class MockButton { constructor(player) { this._player = player; this._el = null; } player () { return this._player; } buildCSSClass () { return 'vjs-control'; } createEl () { const el = window.document.createElement('button'); el.className = this.buildCSSClass(); return el; } el () { if (!this._el) this._el = this.createEl(); return this._el; } } registeredComponents.set('Button', MockButton); const videojs = { getComponent: (name) => registeredComponents.get(name), registerComponent: (name, component) => { registeredComponents.set(name, component); }, }; const events = new Map(); const playerEl = window.document.createElement('div'); const progressControlEl = window.document.createElement('div'); progressControlEl.className = 'vjs-progress-control'; playerEl.appendChild(progressControlEl); const readyCallbacks = []; let currentTime = 0; let durationSeconds = 10; let bufferedEndSeconds = null; const player = { ready (cb) { if (typeof cb !== 'function') return; if (autoReady) { cb(); return; } readyCallbacks.push(cb); }, on (type, fn) { if (!events.has(type)) events.set(type, new Set()); events.get(type).add(fn); }, trigger (type) { const listeners = events.get(type); if (!listeners) return; for (const fn of Array.from(listeners)) fn(); }, currentTime () { return currentTime; }, setCurrentTime (next) { currentTime = Number(next); }, duration (nextValue) { if (typeof nextValue === 'number') { durationSeconds = nextValue; } return durationSeconds; }, bufferedEnd () { return bufferedEndSeconds; }, setBufferedEnd (next) { bufferedEndSeconds = Number.isFinite(next) ? Number(next) : null; }, el () { return playerEl; }, getChild (name) { if (name !== 'controlBar') return null; return { addChild (componentName) { const Component = registeredComponents.get(componentName); if (!Component) return null; const instance = new Component(player); playerEl.appendChild(instance.el()); return instance; }, }; }, flushReady () { while (readyCallbacks.length) { const callback = readyCallbacks.shift(); callback(); } }, }; return { player, videojs }; } function loadSharedVideoPlayer (window) { const script = fs.readFileSync(path.join(__dirname, '../public/shared-video-player.js'), 'utf8'); window.eval(script); return window.FilemanagerSharedVideoPlayer; } describe('shared image subtitle prefetching', () => { function createWindow () { const dom = new JSDOM('', { url: 'http://localhost/', runScripts: 'dangerously', pretendToBeVisual: true, }); dom.window.AbortController = AbortController; dom.window.Response = Response; dom.window.Headers = Headers; dom.window.Request = Request; dom.window.URL.createObjectURL = () => 'blob:subtitle'; dom.window.URL.revokeObjectURL = () => { }; return dom.window; } test('prefetches lookahead frames even when no subtitle is currently active', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedTimes.push(Number(parsed.searchParams.get('timeSeconds'))); return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 1, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window); expect(requestedTimes).toEqual(expect.arrayContaining([0, 0.5, 1])); window.close(); }); test('retries saved image subtitle selection when metadata arrives before player ready runs', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window, { autoReady: false }); const savedPatches = []; window.fetch = jest.fn(async () => new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, })); const controller = helper.bindImageSubtitleOverlay(player, videojs, { imageSubtitleTrackName: 'PGS English', }, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: false }], }, { savePrefs: (patch) => savedPatches.push(patch), buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); player.trigger('loadedmetadata'); controller.captureSelectedTracks(); await flushAsyncWork(window); expect(savedPatches).toEqual(expect.arrayContaining([ expect.objectContaining({ imageSubtitleTrackStreamIndex: 0, imageSubtitleTrackName: 'PGS English', }), ])); window.close(); }); test('keeps image subtitles off when off was the saved preference', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const savedPatches = []; window.fetch = jest.fn(async () => new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, })); const controller = helper.bindImageSubtitleOverlay(player, videojs, { imageSubtitleTrackName: null, imageSubtitleTrackStreamIndex: null, }, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { savePrefs: (patch) => savedPatches.push(patch), buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); controller.captureSelectedTracks(); await flushAsyncWork(window); expect(savedPatches).toEqual(expect.arrayContaining([ expect.objectContaining({ imageSubtitleTrackStreamIndex: null, imageSubtitleTrackName: null, }), ])); expect(window.fetch).not.toHaveBeenCalled(); window.close(); }); test('prefetches subtitle frames through known video duration even with short lookahead', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; player.duration(3); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedTimes.push(Number(parsed.searchParams.get('timeSeconds'))); return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0.5, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 18); expect(requestedTimes).toEqual(expect.arrayContaining([0, 0.5, 1, 1.5, 2, 2.5, 3])); window.close(); }); test('prefetch expands to video end when duration metadata appears later', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; player.duration(Number.NaN); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedTimes.push(Number(parsed.searchParams.get('timeSeconds'))); return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0.5, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 6); expect(requestedTimes).toContain(0); requestedTimes.length = 0; player.duration(4); player.trigger('durationchange'); await flushAsyncWork(window, 14); expect(requestedTimes).toEqual(expect.arrayContaining([0, 0.5, 1, 1.5, 2, 2.5, 3, 3.5, 4])); window.close(); }); test('prefetches at least through the buffered video end', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; player.setBufferedEnd(3); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedTimes.push(Number(parsed.searchParams.get('timeSeconds'))); return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0.5, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 12); expect(requestedTimes).toEqual(expect.arrayContaining([0, 0.5, 1, 1.5, 2, 2.5, 3])); window.close(); }); test('range prefetch clamps the tail window to the known video duration', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedRanges = []; player.duration(10); player.setCurrentTime(8.5); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedRanges.push({ start: Number(parsed.searchParams.get('startTimeSeconds')), end: Number(parsed.searchParams.get('endTimeSeconds')), }); return new Response(JSON.stringify({ status: 'ok', frames: [] }), { status: 200, headers: { 'Content-Type': 'application/json' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, initialPrefetchSeconds: 0, currentFetchEnabled: false, cacheMissFallbackEnabled: false, prefetchAdaptiveStepEnabled: true, prefetchStepSecondsMin: 3, prefetchStepSecondsMax: 3, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), buildPrefetchRequest: ({ currentTime, endTime, streamIndex }) => ({ url: `/subtitle-range?streamIndex=${streamIndex}&startTimeSeconds=${currentTime}&endTimeSeconds=${endTime}`, }), }); player.trigger('timeupdate'); await flushAsyncWork(window, 10); expect(requestedRanges.length).toBeGreaterThan(0); expect(requestedRanges[0]).toEqual({ start: 8.5, end: 10 }); expect(requestedRanges.every((range) => range.end <= 10)).toBe(true); window.close(); }); test('prefetch respects configured larger prefetch step size', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; player.duration(6); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedTimes.push(Number(parsed.searchParams.get('timeSeconds'))); return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, initialPrefetchSeconds: 0, prefetchStepSeconds: 2, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 14); expect(requestedTimes).toEqual(expect.arrayContaining([0, 2, 4, 6])); window.close(); }); test('adaptive prefetch step increases stride when cache lead grows', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; player.duration(40); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedTimes.push(Number(parsed.searchParams.get('timeSeconds'))); return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 20, initialPrefetchSeconds: 0, prefetchAdaptiveStepEnabled: true, prefetchStepSecondsMin: 1, prefetchStepSecondsMax: 5, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 20); const strideSamples = []; for (let i = 1; i < requestedTimes.length; i++) { const stride = requestedTimes[i] - requestedTimes[i - 1]; if (Number.isFinite(stride) && stride > 0) strideSamples.push(Number(stride.toFixed(3))); } expect(strideSamples.some((stride) => stride > 1.25)).toBe(true); window.close(); }); test('prefetch can cache subtitle frames from a range request and render immediately', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedUrls = []; player.duration(12); player.setCurrentTime(2); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedUrls.push(parsed.pathname + parsed.search); if (parsed.pathname === '/subtitle-range') { return new Response(JSON.stringify({ status: 'ok', startTimeSeconds: Number(parsed.searchParams.get('startTimeSeconds')), endTimeSeconds: Number(parsed.searchParams.get('endTimeSeconds')), frames: [ { left: 0, top: 0, width: 320, height: 180, canvasWidth: 640, canvasHeight: 360, startTimeSeconds: 2, endTimeSeconds: 4, contentType: 'image/png', frameBase64: Buffer.from('png-data').toString('base64'), }, ], }), { status: 200, headers: { 'Content-Type': 'application/json' }, }); } return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { currentFetchEnabled: false, cacheMissFallbackEnabled: false, lookaheadSeconds: 0, initialPrefetchSeconds: 0, buildPrefetchRequest: ({ currentTime, endTime, streamIndex }) => ({ url: `/subtitle-range?streamIndex=${streamIndex}&startTimeSeconds=${currentTime}&endTimeSeconds=${endTime}`, }), buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 10); expect(requestedUrls.some((url) => url.startsWith('/subtitle-range'))).toBe(true); expect(requestedUrls.some((url) => url.startsWith('/subtitle-frame'))).toBe(false); const overlay = player.el().querySelector('.video-subtitle-overlay'); expect(overlay).toBeTruthy(); expect(overlay.style.display).toBe('block'); window.close(); }); test('prefetch uses furthest buffered end when player.bufferedEnd under-reports', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; player.setBufferedEnd(0); player.tech = () => ({ el: () => ({ buffered: { length: 1, end: () => 6, }, }), }); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedTimes.push(Number(parsed.searchParams.get('timeSeconds'))); return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 16); expect(requestedTimes).toEqual(expect.arrayContaining([0, 0.5, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 5.5, 6])); window.close(); }); test('prefetch frontier jumps to current playback time instead of replaying stale lag', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; player.duration(60); player.setBufferedEnd(2); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); requestedTimes.push(timeSeconds); return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); expect(requestedTimes).toEqual(expect.arrayContaining([0, 0.5])); requestedTimes.length = 0; player.setCurrentTime(20); player.setBufferedEnd(40); player.trigger('timeupdate'); await flushAsyncWork(window, 8); expect(requestedTimes).toContain(20); expect(requestedTimes.some((value) => value < 20)).toBe(false); const prefetchAfterJump = requestedTimes.filter((value) => value > 20); if (prefetchAfterJump.length) { expect(Math.min(...prefetchAfterJump)).toBeGreaterThanOrEqual(20.5); } window.close(); }); test('does not restart current subtitle request while one is in flight', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const pendingResolvers = []; const requestTimes = []; window.fetch = jest.fn((url, init = {}) => { const parsed = new URL(url, 'http://localhost/'); requestTimes.push(Number(parsed.searchParams.get('timeSeconds'))); if (pendingResolvers.length === 0) { return new Promise((resolve) => { pendingResolvers.push(() => resolve(new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }))); }); } expect(init.signal && init.signal.aborted).toBe(false); return Promise.resolve(new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, })); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 3); expect(window.fetch).toHaveBeenCalledTimes(1); player.setCurrentTime(1.5); player.trigger('timeupdate'); player.setCurrentTime(2.25); player.trigger('timeupdate'); await flushAsyncWork(window, 2); expect(window.fetch).toHaveBeenCalledTimes(1); pendingResolvers[0](); await flushAsyncWork(window, 5); expect(window.fetch.mock.calls.length).toBeGreaterThanOrEqual(2); expect(requestTimes).toEqual(expect.arrayContaining([0, 2.25])); window.close(); }); test('renders a prefetched frame for the current paused time without waiting for another timeupdate', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); player.duration(120); player.setCurrentTime(118.95); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); const headers = { 'Content-Type': 'image/png', }; if (Math.abs(timeSeconds - 118.95) < 0.001) { headers['X-Subtitle-Frame-Start-Time'] = '118.90'; headers['X-Subtitle-Frame-End-Time'] = '119.00'; headers['X-Subtitle-Frame-Width'] = '640'; headers['X-Subtitle-Frame-Height'] = '80'; headers['X-Subtitle-Frame-Canvas-Width'] = '1920'; headers['X-Subtitle-Frame-Canvas-Height'] = '1080'; return new Response(new Uint8Array([137, 80, 78, 71]), { status: 200, headers }); } return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { currentFetchEnabled: false, cacheMissFallbackEnabled: false, lookaheadSeconds: 0, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 10); const overlay = player.el().querySelector('.video-subtitle-overlay'); const overlayImg = overlay && overlay.querySelector('img'); expect(overlay).toBeTruthy(); expect(overlayImg).toBeTruthy(); expect(overlay.style.display).toBe('block'); expect(overlayImg.getAttribute('src')).toBe('blob:subtitle'); window.close(); }); test('syncs caption visibility from cache between sparse timeupdate events', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); // JSDOM raf cadence can be inconsistent; force timeout fallback for stable checks. window.requestAnimationFrame = undefined; window.cancelAnimationFrame = undefined; player.duration(20); window.fetch = jest.fn(async () => { return new Response(new Uint8Array([137, 80, 78, 71]), { status: 200, headers: { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Start-Time': '1', 'X-Subtitle-Frame-End-Time': '2', 'X-Subtitle-Frame-Width': '640', 'X-Subtitle-Frame-Height': '80', 'X-Subtitle-Frame-Canvas-Width': '1920', 'X-Subtitle-Frame-Canvas-Height': '1080', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); const overlay = player.el().querySelector('.video-subtitle-overlay'); expect(overlay).toBeTruthy(); player.setCurrentTime(1.2); player.trigger('play'); await new Promise((resolve) => window.setTimeout(resolve, 50)); await flushAsyncWork(window, 2); expect(overlay.style.display).toBe('block'); player.setCurrentTime(2.2); await new Promise((resolve) => window.setTimeout(resolve, 50)); await flushAsyncWork(window, 2); expect(overlay.style.display).toBe('none'); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('uses video-frame media clock for precise cached caption timing', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); let frameCallback = null; let frameCallbackId = 0; const videoEl = window.document.createElement('video'); videoEl.requestVideoFrameCallback = jest.fn((cb) => { frameCallback = cb; frameCallbackId += 1; return frameCallbackId; }); videoEl.cancelVideoFrameCallback = jest.fn(); player.el().appendChild(videoEl); window.fetch = jest.fn(async () => { return new Response(new Uint8Array([137, 80, 78, 71]), { status: 200, headers: { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Start-Time': '1', 'X-Subtitle-Frame-End-Time': '2', 'X-Subtitle-Frame-Width': '640', 'X-Subtitle-Frame-Height': '80', 'X-Subtitle-Frame-Canvas-Width': '1920', 'X-Subtitle-Frame-Canvas-Height': '1080', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, initialPrefetchSeconds: 0, currentFetchEnabled: false, cacheMissFallbackEnabled: false, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); const overlay = player.el().querySelector('.video-subtitle-overlay'); expect(overlay).toBeTruthy(); expect(videoEl.requestVideoFrameCallback).toHaveBeenCalled(); expect(typeof frameCallback).toBe('function'); player.setCurrentTime(9); player.trigger('play'); frameCallback(1000, { mediaTime: 1.5 }); await flushAsyncWork(window, 3); expect(overlay.style.display).toBe('block'); const nextFrameCallback = frameCallback; nextFrameCallback(1016, { mediaTime: 2.2 }); await flushAsyncWork(window, 3); expect(overlay.style.display).toBe('none'); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('keeps tightly spaced captions renderable across near-boundary samples', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); let objectUrlSeq = 0; window.URL.createObjectURL = () => `blob:subtitle-${++objectUrlSeq}`; window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); const headers = { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Width': '640', 'X-Subtitle-Frame-Height': '80', 'X-Subtitle-Frame-Canvas-Width': '1920', 'X-Subtitle-Frame-Canvas-Height': '1080', }; if (Math.abs(timeSeconds - 8.351) < 0.02) { headers['X-Subtitle-Frame-Start-Time'] = '8.351'; headers['X-Subtitle-Frame-End-Time'] = '8.410'; } else { return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); } return new Response(new Uint8Array([137, 80, 78, 71]), { status: 200, headers, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { currentFetchEnabled: false, cacheMissFallbackEnabled: false, lookaheadSeconds: 0, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); const overlay = player.el().querySelector('.video-subtitle-overlay'); const overlayImg = overlay && overlay.querySelector('img'); expect(overlay).toBeTruthy(); player.setCurrentTime(8.344); player.trigger('play'); await new Promise((resolve) => window.setTimeout(resolve, 50)); await flushAsyncWork(window, 2); expect(overlay.style.display).toBe('block'); expect(overlayImg.getAttribute('src')).toBe('blob:subtitle-1'); window.close(); }); test('resyncs the displayed caption after a seek without waiting for timeupdate', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); window.requestAnimationFrame = undefined; window.cancelAnimationFrame = undefined; window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); const headers = { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Width': '640', 'X-Subtitle-Frame-Height': '80', 'X-Subtitle-Frame-Canvas-Width': '1920', 'X-Subtitle-Frame-Canvas-Height': '1080', }; if (Math.abs(timeSeconds - 1.2) < 0.001) { headers['X-Subtitle-Frame-Start-Time'] = '1.0'; headers['X-Subtitle-Frame-End-Time'] = '2.0'; } else if (Math.abs(timeSeconds - 3.2) < 0.001) { headers['X-Subtitle-Frame-Start-Time'] = '3.0'; headers['X-Subtitle-Frame-End-Time'] = '4.0'; } else { return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); } return new Response(new Uint8Array([137, 80, 78, 71]), { status: 200, headers, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { currentFetchEnabled: false, cacheMissFallbackEnabled: false, lookaheadSeconds: 0, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); const overlay = player.el().querySelector('.video-subtitle-overlay'); expect(overlay).toBeTruthy(); player.setCurrentTime(1.2); player.trigger('play'); await new Promise((resolve) => window.setTimeout(resolve, 50)); await flushAsyncWork(window, 2); expect(overlay.style.display).toBe('block'); player.trigger('pause'); player.setCurrentTime(3.2); player.trigger('seeked'); await flushAsyncWork(window, 6); expect(overlay.style.display).toBe('block'); expect(overlay.querySelector('img').getAttribute('src')).toBe('blob:subtitle'); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('defers periodic resync while caption is visible and runs it after caption ends', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; window.requestAnimationFrame = undefined; window.cancelAnimationFrame = undefined; player.setCurrentTime(1.2); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); requestedTimes.push(timeSeconds); const headers = { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Width': '640', 'X-Subtitle-Frame-Height': '80', 'X-Subtitle-Frame-Canvas-Width': '1920', 'X-Subtitle-Frame-Canvas-Height': '1080', }; if (Math.abs(timeSeconds - 1.2) < 0.01) { headers['X-Subtitle-Frame-Start-Time'] = '1.0'; headers['X-Subtitle-Frame-End-Time'] = '2.0'; return new Response(new Uint8Array([137, 80, 78, 71]), { status: 200, headers, }); } return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, initialPrefetchSeconds: 0, periodicResyncIntervalMs: 120, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); player.trigger('play'); await new Promise((resolve) => window.setTimeout(resolve, 300)); await flushAsyncWork(window, 2); const fetchCallsDuringCaption = window.fetch.mock.calls.length; player.setCurrentTime(20); await new Promise((resolve) => window.setTimeout(resolve, 160)); await flushAsyncWork(window, 3); expect(window.fetch.mock.calls.length).toBeGreaterThan(fetchCallsDuringCaption); expect(requestedTimes.some((time) => Math.abs(time - 20) < 0.01)).toBe(true); window.close(); }); test('aborts in-flight prefetch requests when the overlay is detached', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const activeSignals = []; window.fetch = jest.fn((url, init = {}) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); if (timeSeconds === 0) { return Promise.resolve(new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, })); } activeSignals.push(init.signal || null); return new Promise((resolve, reject) => { if (init.signal && typeof init.signal.addEventListener === 'function') { init.signal.addEventListener('abort', () => { reject(new DOMException('Aborted', 'AbortError')); }, { once: true }); } }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 1, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 3); expect(activeSignals.length).toBeGreaterThan(0); controller.detach(); await flushAsyncWork(window, 2); expect(activeSignals.every(signal => signal && signal.aborted)).toBe(true); window.close(); }); test('logs current subtitle request lifecycle events and flushes them on detach', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const sentBatches = []; window.fetch = jest.fn(async () => { return new Response('png-data', { status: 200, headers: { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Status': 'ok', 'X-Subtitle-Request-Received-At-Ms': '1000', 'X-Subtitle-Response-Sent-At-Ms': '1012', 'X-Subtitle-Frame-Start-Time': '1.5', 'X-Subtitle-Frame-End-Time': '3.2', 'X-Subtitle-Frame-Width': '320', 'X-Subtitle-Frame-Height': '180', 'X-Subtitle-Frame-Canvas-Width': '640', 'X-Subtitle-Frame-Canvas-Height': '360', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { sessionId: 'sess-1', imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, sendSubtitleLogBatch: (entries) => { sentBatches.push(entries); return Promise.resolve(); }, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); controller.detach(); await flushAsyncWork(window, 4); const flattened = sentBatches.flat(); expect(flattened.map((entry) => entry.eventType)).toEqual(expect.arrayContaining([ 'subtitle_png_requested', 'subtitle_png_sent', 'subtitle_png_received', ])); window.close(); }); test('logs prefetch subtitle lifecycle events', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const sentBatches = []; window.fetch = jest.fn(async () => { return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none', 'X-Subtitle-Request-Received-At-Ms': '1000', 'X-Subtitle-Response-Sent-At-Ms': '1010', 'X-Subtitle-Frame-Start-Time': '2', 'X-Subtitle-Frame-End-Time': '3', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { sessionId: 'sess-1', imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 1, sendSubtitleLogBatch: (entries) => { sentBatches.push(entries); return Promise.resolve(); }, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); controller.detach(); await flushAsyncWork(window, 4); const flattened = sentBatches.flat(); const prefetchEvents = flattened.filter((entry) => entry.requestKind === 'prefetch').map((entry) => entry.eventType); expect(prefetchEvents).toEqual(expect.arrayContaining([ 'subtitle_png_requested', 'subtitle_png_sent', 'subtitle_png_not_available', ])); window.close(); }); test('cache-only current mode avoids direct current subtitle fetch requests', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const sentBatches = []; player.setCurrentTime(8); window.fetch = jest.fn(async () => { return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none', 'X-Subtitle-Request-Received-At-Ms': '1000', 'X-Subtitle-Response-Sent-At-Ms': '1010', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { sessionId: 'sess-1', imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { currentFetchEnabled: false, cacheMissFallbackEnabled: false, lookaheadSeconds: 0, sendSubtitleLogBatch: (entries) => { sentBatches.push(entries); return Promise.resolve(); }, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); controller.detach(); await flushAsyncWork(window, 4); const flattened = sentBatches.flat(); expect(flattened.length).toBeGreaterThan(0); const requestKinds = new Set(flattened.map((entry) => entry.requestKind).filter(Boolean)); expect(requestKinds.has('prefetch')).toBe(true); expect(requestKinds.has('current')).toBe(false); window.close(); }); test('cache-only mode falls back to throttled current fetch on cache miss', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); let requestCount = 0; window.fetch = jest.fn(async () => { requestCount += 1; if (requestCount === 1) { return new Response(new Uint8Array([137, 80, 78, 71]), { status: 200, headers: { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Start-Time': '2.00', 'X-Subtitle-Frame-End-Time': '2.50', 'X-Subtitle-Frame-Width': '600', 'X-Subtitle-Frame-Height': '72', 'X-Subtitle-Frame-Canvas-Width': '1920', 'X-Subtitle-Frame-Canvas-Height': '1080', }, }); } return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, }); }); player.setCurrentTime(2.2); helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { currentFetchEnabled: false, cacheMissFallbackIntervalMs: 2000, lookaheadSeconds: 0, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 10); const overlay = player.el().querySelector('.video-subtitle-overlay'); const overlayImg = overlay && overlay.querySelector('img'); expect(window.fetch).toHaveBeenCalled(); expect(overlay.style.display).toBe('block'); expect(overlayImg.getAttribute('src')).toBe('blob:subtitle'); window.close(); }); test('cache-miss fallback does not reset prefetch progress on repeated triggers', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); let nowMs = 1000; const realNow = window.Date.now; window.Date.now = () => nowMs; let abortedCount = 0; window.fetch = jest.fn((url, init = {}) => { return new Promise((resolve, reject) => { const signal = init && init.signal; const onAbort = () => { abortedCount += 1; const err = new Error('aborted'); err.name = 'AbortError'; reject(err); }; if (signal && typeof signal.addEventListener === 'function') { if (signal.aborted) return onAbort(); signal.addEventListener('abort', onAbort, { once: true }); } window.setTimeout(() => { if (signal && signal.aborted) return; resolve(new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, })); }, 80); }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { currentFetchEnabled: false, cacheMissFallbackIntervalMs: 20, lookaheadSeconds: 2, initialPrefetchSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 4); player.setCurrentTime(5); player.trigger('timeupdate'); nowMs += 40; player.setCurrentTime(5.5); player.trigger('timeupdate'); nowMs += 40; player.setCurrentTime(6); player.trigger('timeupdate'); await flushAsyncWork(window, 12); expect(abortedCount).toBe(0); window.Date.now = realNow; controller.detach(); window.close(); }); test('cache-only mode performs initial warmup prefetch window on load', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); requestedTimes.push(Number(parsed.searchParams.get('timeSeconds'))); return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none', 'X-Subtitle-Request-Received-At-Ms': '1000', 'X-Subtitle-Response-Sent-At-Ms': '1010', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { currentFetchEnabled: false, lookaheadSeconds: 0, initialPrefetchSeconds: 2, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 12); expect(requestedTimes).toEqual(expect.arrayContaining([0, 0.5, 1, 1.5, 2])); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('renders requested and received subtitle markers on the seek bar', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); window.fetch = jest.fn(async () => { return new Response('png-data', { status: 200, headers: { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Status': 'ok', 'X-Subtitle-Request-Received-At-Ms': '1000', 'X-Subtitle-Response-Sent-At-Ms': '1012', 'X-Subtitle-Frame-Start-Time': '2.5', 'X-Subtitle-Frame-End-Time': '3.5', 'X-Subtitle-Frame-Width': '320', 'X-Subtitle-Frame-Height': '180', 'X-Subtitle-Frame-Canvas-Width': '640', 'X-Subtitle-Frame-Canvas-Height': '360', }, }); }); player.duration(10); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); const requestedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-right'); const receivedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-left'); expect(requestedMarker).toBeTruthy(); expect(receivedMarker).toBeTruthy(); expect(requestedMarker.style.display).toBe('block'); expect(receivedMarker.style.display).toBe('block'); expect(requestedMarker.style.left).toBe('100.0000%'); expect(receivedMarker.style.left).toBe('25.0000%'); expect(requestedMarker.textContent).toBe(']'); expect(receivedMarker.textContent).toBe('['); controller.detach(); await new Promise((resolve) => window.setTimeout(resolve, 300)); await flushAsyncWork(window, 2); window.close(); }); test('advances both seek markers when subtitle request returns 204 without frame timing headers', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); player.duration(10); player.setCurrentTime(4); window.fetch = jest.fn(async () => { return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none', 'X-Subtitle-Request-Received-At-Ms': '1000', 'X-Subtitle-Response-Sent-At-Ms': '1010', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); const requestedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-right'); const receivedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-left'); expect(requestedMarker).toBeTruthy(); expect(receivedMarker).toBeTruthy(); expect(requestedMarker.style.display).toBe('block'); expect(receivedMarker.style.display).toBe('block'); expect(requestedMarker.style.left).toBe('100.0000%'); expect(receivedMarker.style.left).toBe('100.0000%'); expect(requestedMarker.textContent).toBe(']'); expect(receivedMarker.textContent).toBe('['); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('advances seek markers to the end of an empty prefetch tail window', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); player.duration(120); player.setCurrentTime(110); window.fetch = jest.fn(async () => { return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none', 'X-Subtitle-Request-Received-At-Ms': '1000', 'X-Subtitle-Response-Sent-At-Ms': '1010', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, initialPrefetchSeconds: 0, currentFetchEnabled: false, cacheMissFallbackEnabled: false, prefetchAdaptiveStepEnabled: true, prefetchStepSecondsMin: 10, prefetchStepSecondsMax: 10, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), buildPrefetchRequest: ({ currentTime, endTime, streamIndex }) => ({ url: `/subtitle-range?streamIndex=${streamIndex}&startTimeSeconds=${currentTime}&endTimeSeconds=${endTime}`, }), }); player.trigger('timeupdate'); await flushAsyncWork(window, 8); const requestedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-right'); const receivedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-left'); expect(requestedMarker).toBeTruthy(); expect(receivedMarker).toBeTruthy(); expect(requestedMarker.style.left).toBe('100.0000%'); expect(receivedMarker.style.left).toBe('100.0000%'); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('keeps existing marker positions while the next request is still in flight', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); let pendingResolve = null; player.duration(10); window.fetch = jest.fn((url) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); if (timeSeconds === 0) { return Promise.resolve(new Response('png-data', { status: 200, headers: { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Status': 'ok', 'X-Subtitle-Frame-Start-Time': '2', 'X-Subtitle-Frame-End-Time': '3', 'X-Subtitle-Frame-Width': '320', 'X-Subtitle-Frame-Height': '180', 'X-Subtitle-Frame-Canvas-Width': '640', 'X-Subtitle-Frame-Canvas-Height': '360', }, })); } return new Promise((resolve) => { pendingResolve = resolve; }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); const requestedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-right'); const receivedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-left'); expect(requestedMarker).toBeTruthy(); expect(receivedMarker).toBeTruthy(); expect(requestedMarker.style.left).toBe('0.0000%'); expect(receivedMarker.style.left).toBe('20.0000%'); player.setCurrentTime(1.5); player.trigger('timeupdate'); await flushAsyncWork(window, 2); expect(requestedMarker.style.left).toBe('0.0000%'); expect(receivedMarker.style.left).toBe('20.0000%'); pendingResolve(new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none', }, })); await flushAsyncWork(window, 8); expect(requestedMarker.style.display).toBe('block'); expect(receivedMarker.style.display).toBe('block'); expect(requestedMarker.style.left).toBe('15.0000%'); expect(receivedMarker.style.left).toBe('20.0000%'); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('keeps marker positions forward-only when later responses resolve with earlier times', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; player.duration(12); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); requestedTimes.push(timeSeconds); if (requestedTimes.length === 1) { return new Response('png-data', { status: 200, headers: { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Status': 'ok', 'X-Subtitle-Frame-Start-Time': '4', 'X-Subtitle-Frame-End-Time': '5', 'X-Subtitle-Frame-Width': '320', 'X-Subtitle-Frame-Height': '180', 'X-Subtitle-Frame-Canvas-Width': '640', 'X-Subtitle-Frame-Canvas-Height': '360', }, }); } return new Response('png-data', { status: 200, headers: { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Status': 'ok', 'X-Subtitle-Frame-Start-Time': '2', 'X-Subtitle-Frame-End-Time': '3', 'X-Subtitle-Frame-Width': '320', 'X-Subtitle-Frame-Height': '180', 'X-Subtitle-Frame-Canvas-Width': '640', 'X-Subtitle-Frame-Canvas-Height': '360', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); const requestedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-right'); const receivedMarker = player.el().querySelector('.vjs-image-subtitle-seek-marker-left'); expect(requestedMarker).toBeTruthy(); expect(receivedMarker).toBeTruthy(); expect(requestedMarker.style.left).toBe('100.0000%'); expect(receivedMarker.style.left).toBe('33.3333%'); player.setCurrentTime(1.5); player.trigger('timeupdate'); await flushAsyncWork(window, 8); // Second response reports an older start time, but markers stay monotonic. expect(requestedMarker.style.left).toBe('100.0000%'); expect(receivedMarker.style.left).toBe('33.3333%'); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('continues current subtitle refreshes after a force-seek aborts the in-flight request', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; window.fetch = jest.fn((url, init = {}) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); requestedTimes.push(timeSeconds); if (requestedTimes.length === 1) { return new Promise((resolve, reject) => { if (init.signal && typeof init.signal.addEventListener === 'function') { init.signal.addEventListener('abort', () => { reject(new window.DOMException('Aborted', 'AbortError')); }, { once: true }); } }); } return Promise.resolve(new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none', }, })); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, currentRequestTimeoutMs: 300, logToConsole: false, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 4); const afterInitialLoadCalls = window.fetch.mock.calls.length; expect(afterInitialLoadCalls).toBeGreaterThan(0); player.setCurrentTime(5); player.trigger('seeking'); await flushAsyncWork(window, 20); expect(window.fetch.mock.calls.length).toBeGreaterThanOrEqual(2); expect(requestedTimes).toEqual(expect.arrayContaining([0, 5])); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('recovers when a current subtitle request hangs and times out', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); const requestedTimes = []; window.fetch = jest.fn((url, init = {}) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); requestedTimes.push(timeSeconds); if (requestedTimes.length === 1) { return new Promise((resolve, reject) => { if (init.signal && typeof init.signal.addEventListener === 'function') { init.signal.addEventListener('abort', () => { reject(new window.DOMException('Aborted', 'AbortError')); }, { once: true }); } }); } return Promise.resolve(new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none' }, })); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, currentRequestTimeoutMs: 250, logToConsole: false, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 3); player.setCurrentTime(1.5); player.trigger('timeupdate'); await new Promise((resolve) => window.setTimeout(resolve, 320)); player.trigger('timeupdate'); await new Promise((resolve) => window.setTimeout(resolve, 220)); await flushAsyncWork(window, 20); expect(window.fetch.mock.calls.length).toBeGreaterThanOrEqual(2); expect(requestedTimes).toEqual(expect.arrayContaining([0, 1.5])); controller.detach(); await new Promise((resolve) => window.setTimeout(resolve, 200)); await flushAsyncWork(window, 20); window.close(); }); test('reuses cached subtitle frames after rewinding when server no longer has older frames', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const { player, videojs } = buildPlayerHarness(window); player.duration(10); player.setCurrentTime(2); window.fetch = jest.fn(async (url) => { const parsed = new URL(url, 'http://localhost/'); const timeSeconds = Number(parsed.searchParams.get('timeSeconds')); if (Math.abs(timeSeconds - 2) < 1e-6) { return new Response('png-data', { status: 200, headers: { 'Content-Type': 'image/png', 'X-Subtitle-Frame-Status': 'ok', 'X-Subtitle-Frame-Start-Time': '2', 'X-Subtitle-Frame-End-Time': '3', 'X-Subtitle-Frame-Width': '320', 'X-Subtitle-Frame-Height': '180', 'X-Subtitle-Frame-Canvas-Width': '640', 'X-Subtitle-Frame-Canvas-Height': '360', }, }); } return new Response(null, { status: 204, headers: { 'X-Subtitle-Frame-Status': 'none', }, }); }); const controller = helper.bindImageSubtitleOverlay(player, videojs, {}, { imageSubtitleTracks: [{ label: 'PGS English', streamIndex: 0, default: true }], }, { lookaheadSeconds: 0, buildFrameRequest: ({ currentTime, streamIndex }) => ({ url: `/subtitle-frame?streamIndex=${streamIndex}&timeSeconds=${currentTime}`, }), }); await flushAsyncWork(window, 8); const afterInitialLoadCalls = window.fetch.mock.calls.length; expect(afterInitialLoadCalls).toBeGreaterThan(0); player.setCurrentTime(4); player.trigger('timeupdate'); await flushAsyncWork(window, 8); const afterForwardSeekCalls = window.fetch.mock.calls.length; expect(afterForwardSeekCalls).toBeGreaterThanOrEqual(afterInitialLoadCalls); const overlay = player.el().querySelector('.video-subtitle-overlay'); expect(overlay).toBeTruthy(); expect(overlay.style.display).toBe('none'); player.setCurrentTime(2.5); player.trigger('timeupdate'); await flushAsyncWork(window, 8); expect(window.fetch.mock.calls.length).toBe(afterForwardSeekCalls); expect(overlay.style.display).toBe('block'); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); test('registers stream cache service worker once when supported', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const register = jest.fn(async () => ({})); window.navigator.serviceWorker = { register }; const first = await helper.enableVideoStreamClientCache(); const second = await helper.enableVideoStreamClientCache(); expect(first).toBe(true); expect(second).toBe(true); expect(register).toHaveBeenCalledTimes(1); expect(register).toHaveBeenCalledWith('/stream-cache-sw.js', { scope: '/', updateViaCache: 'none', }); window.close(); }); test('stream-ahead prefetch follows playlists and fetches segment assets', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const requestedUrls = []; window.fetch = jest.fn(async (input) => { const url = String(input && input.url ? input.url : input); requestedUrls.push(url); if (url === 'http://localhost/master.m3u8') { return new Response('#EXTM3U\n#EXT-X-STREAM-INF:BANDWIDTH=100000\nstream_0.m3u8\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/stream_0.m3u8') { return new Response('#EXTM3U\n#EXTINF:4,\nseg0.ts\n#EXTINF:4,\nseg1.ts\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/seg0.ts' || url === 'http://localhost/seg1.ts') { return new Response(new Uint8Array([1, 2, 3, 4]), { status: 200, headers: { 'Content-Type': 'video/mp2t' }, }); } return new Response(null, { status: 404 }); }); const controller = helper.bindStreamAheadPrefetch({ playlistUrl: 'http://localhost/master.m3u8', pollIntervalMs: 0, credentials: 'same-origin', }); expect(controller).toBeTruthy(); await controller.done(); expect(requestedUrls).toEqual(expect.arrayContaining([ 'http://localhost/master.m3u8', 'http://localhost/stream_0.m3u8', 'http://localhost/seg0.ts', 'http://localhost/seg1.ts', ])); controller.stop(); window.close(); }); test('stream-ahead prefetch reports cached-through progress for fetched segments', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const progressSamples = []; window.fetch = jest.fn(async (input) => { const url = String(input && input.url ? input.url : input); if (url === 'http://localhost/master.m3u8') { return new Response('#EXTM3U\n#EXT-X-STREAM-INF:BANDWIDTH=100000\nstream_0.m3u8\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/stream_0.m3u8') { return new Response('#EXTM3U\n#EXTINF:4,\nseg0.ts\n#EXTINF:4,\nseg1.ts\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/seg0.ts' || url === 'http://localhost/seg1.ts') { return new Response(new Uint8Array([1, 2, 3, 4]), { status: 200, headers: { 'Content-Type': 'video/mp2t' }, }); } return new Response(null, { status: 404 }); }); const controller = helper.bindStreamAheadPrefetch({ playlistUrl: 'http://localhost/master.m3u8', pollIntervalMs: 0, credentials: 'same-origin', }); expect(controller).toBeTruthy(); const unsubscribe = controller.subscribe((status) => { progressSamples.push(status && status.cachedThroughSeconds); }); await controller.done(); unsubscribe(); expect(progressSamples.some((value) => Number.isFinite(value) && value >= 8)).toBe(true); controller.stop(); window.close(); }); test('stream-ahead prefetch infers cached-through progress from segment filenames', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const progressSamples = []; window.fetch = jest.fn(async (input) => { const url = String(input && input.url ? input.url : input); if (url === 'http://localhost/master.m3u8') { return new Response('#EXTM3U\n#EXT-X-STREAM-INF:BANDWIDTH=100000\nstream_0.m3u8\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/stream_0.m3u8') { return new Response('#EXTM3U\nstream_0_segment_000000.ts\nstream_0_segment_000001.ts\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/stream_0_segment_000000.ts' || url === 'http://localhost/stream_0_segment_000001.ts') { return new Response(new Uint8Array([1, 2, 3, 4]), { status: 200, headers: { 'Content-Type': 'video/mp2t' }, }); } return new Response(null, { status: 404 }); }); const controller = helper.bindStreamAheadPrefetch({ playlistUrl: 'http://localhost/master.m3u8', pollIntervalMs: 0, credentials: 'same-origin', }); expect(controller).toBeTruthy(); const unsubscribe = controller.subscribe((status) => { progressSamples.push(status && status.cachedThroughSeconds); }); await controller.done(); unsubscribe(); expect(progressSamples.some((value) => Number.isFinite(value) && value >= 8)).toBe(true); controller.stop(); window.close(); }); test('stream-ahead prefetch infers cached-through progress for m4s segment filenames', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const progressSamples = []; window.fetch = jest.fn(async (input) => { const url = String(input && input.url ? input.url : input); if (url === 'http://localhost/master.m3u8') { return new Response('#EXTM3U\n#EXT-X-STREAM-INF:BANDWIDTH=100000\nstream_0.m3u8\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/stream_0.m3u8') { return new Response('#EXTM3U\nstream_0_segment_000000.m4s\nstream_0_segment_000001.m4s\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/stream_0_segment_000000.m4s' || url === 'http://localhost/stream_0_segment_000001.m4s') { return new Response(new Uint8Array([1, 2, 3, 4]), { status: 200, headers: { 'Content-Type': 'video/mp4' }, }); } return new Response(null, { status: 404 }); }); const controller = helper.bindStreamAheadPrefetch({ playlistUrl: 'http://localhost/master.m3u8', pollIntervalMs: 0, credentials: 'same-origin', }); expect(controller).toBeTruthy(); const unsubscribe = controller.subscribe((status) => { progressSamples.push(status && status.cachedThroughSeconds); }); await controller.done(); unsubscribe(); expect(progressSamples.some((value) => Number.isFinite(value) && value >= 8)).toBe(true); controller.stop(); window.close(); }); test('stream-ahead prefetch reports ratio progress from fetched sections when timing is unknown', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const statusSamples = []; window.fetch = jest.fn(async (input) => { const url = String(input && input.url ? input.url : input); if (url === 'http://localhost/master.m3u8') { return new Response('#EXTM3U\n#EXT-X-STREAM-INF:BANDWIDTH=100000\nstream_0.m3u8\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/stream_0.m3u8') { return new Response('#EXTM3U\nchunk-alpha.bin\nchunk-beta.bin\n#EXT-X-ENDLIST\n', { status: 200, headers: { 'Content-Type': 'application/vnd.apple.mpegurl' }, }); } if (url === 'http://localhost/chunk-alpha.bin' || url === 'http://localhost/chunk-beta.bin') { return new Response(new Uint8Array([1, 2, 3, 4]), { status: 200, headers: { 'Content-Type': 'application/octet-stream' }, }); } return new Response(null, { status: 404 }); }); const controller = helper.bindStreamAheadPrefetch({ playlistUrl: 'http://localhost/master.m3u8', pollIntervalMs: 0, credentials: 'same-origin', }); expect(controller).toBeTruthy(); const unsubscribe = controller.subscribe((status) => { statusSamples.push(status || {}); }); await controller.done(); unsubscribe(); const finalStatus = statusSamples[statusSamples.length - 1] || {}; expect(finalStatus.totalSegmentCount).toBe(2); expect(finalStatus.fetchedSegmentCount).toBe(2); expect(finalStatus.cachedThroughRatio).toBe(1); controller.stop(); window.close(); }); test('clears cached stream assets for a finished playlist session', async () => { const window = createWindow(); const helper = loadSharedVideoPlayer(window); const requests = [ new window.Request('http://localhost/api/files/video-stream/sess-a/master.m3u8'), new window.Request('http://localhost/api/files/video-stream/sess-a/stream_0_segment_000001.ts'), new window.Request('http://localhost/api/files/video-stream/sess-b/master.m3u8'), ]; const deleteCalls = []; const cache = { keys: jest.fn(async () => requests), delete: jest.fn(async (request) => { deleteCalls.push(request.url); return true; }), }; window.caches = { open: jest.fn(async () => cache), }; await helper.clearVideoStreamClientCache('http://localhost/api/files/video-stream/sess-a/master.m3u8'); expect(window.caches.open).toHaveBeenCalledWith('filemanager-stream-cache-v1'); expect(cache.keys).toHaveBeenCalledTimes(1); expect(deleteCalls).toEqual(expect.arrayContaining([ 'http://localhost/api/files/video-stream/sess-a/master.m3u8', 'http://localhost/api/files/video-stream/sess-a/stream_0_segment_000001.ts', ])); expect(deleteCalls).not.toContain('http://localhost/api/files/video-stream/sess-b/master.m3u8'); window.close(); }); });