'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) { const registeredComponents = new Map(); 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); let currentTime = 0; let durationSeconds = 10; const player = { ready (cb) { if (typeof cb === 'function') 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; }, 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; }, }; }, }; 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('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, 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('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('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('25.0000%'); expect(receivedMarker.style.left).toBe('25.0000%'); controller.detach(); await flushAsyncWork(window, 2); window.close(); }); });