Files
Neutron/tests/fidelity-viewer.test.mjs
T

215 lines
11 KiB
JavaScript

import nodeTest from 'node:test';
import assert from 'node:assert/strict';
import {existsSync} from 'node:fs';
let declared = 0;
function test(name, action) { declared++; return nodeTest(name, action); }
const modulePath = new URL('../tools/recon/fidelity_viewer/viewer.mjs', import.meta.url);
const api = existsSync(modulePath) ? await import(modulePath) : {};
class Media extends EventTarget {
currentTime = 0; duration = 20; playbackRate = 1; muted = false; volume = 1;
readyState = 4; paused = true; ended = false; seeking = false; error = null;
failPlay = false;
pause() { this.paused = true; }
async play() { if (this.failPlay) throw Error('blocked'); this.paused = false; }
emit(name) { this.dispatchEvent(new Event(name)); }
}
function pair() {
assert.equal(typeof api.createPairController, 'function', 'paired media controller must exist');
const original = new Media(), port = new Media();
const controller = api.createPairController({original, port});
return {original, port, controller};
}
const marker = {name: 'landing', original: {media_seconds: 2, elapsed_seconds: 2, uncertainty_seconds: .02},
port: {media_seconds: 3, elapsed_seconds: 3.2, uncertainty_seconds: .03}};
test('event selection seeks independent observed times and waits for explicit play', async () => {
const {controller, original, port} = pair();
await controller.selectEvent(marker);
assert.equal(original.currentTime, 2); assert.equal(port.currentTime, 3);
assert.ok(original.paused && port.paused);
await controller.play();
assert.equal(original.playbackRate, 1); assert.equal(port.playbackRate, 1);
assert.ok(!original.paused && !port.paused);
});
test('invalid or unmatched event cannot seek either recording', async () => {
const {controller, original} = pair();
for (const invalid of [{...marker, port: null}, {...marker, original: {...marker.original, media_seconds: Infinity}},
{...marker, port: {...marker.port, media_seconds: 99}}]) {
await assert.rejects(controller.selectEvent(invalid));
assert.equal(original.currentTime, 0);
}
});
test('play rejection pauses both and names the cause', async () => {
const {controller, original, port} = pair(); port.failPlay = true;
assert.equal(await controller.play(), false);
assert.ok(original.paused && port.paused);
assert.match(controller.snapshot().problem, /play.*blocked/i);
});
test('relative artifact links reject remote and active URL schemes', () => {
assert.equal(typeof api.safeLocalURL, 'function');
assert.equal(api.safeLocalURL('sides/port/trace.json'), 'sides/port/trace.json');
for (const value of ['https://host/x', 'javascript:alert(1)', '//host/x', '../x', '/etc/passwd', '%2e%2e/x'])
assert.throws(() => api.safeLocalURL(value));
});
test('capability navigation is supplied through a renderer', () => {
assert.equal(typeof api.renderCapabilities, 'function');
});
test('raw elapsed, event drift and playback drift are distinct', async () => {
const {controller, original, port} = pair();
await controller.selectEvent(marker);
original.currentTime = 5; port.currentTime = 6.25;
const s = controller.snapshot();
assert.equal(s.sides.original.recording_seconds, 5);
assert.equal(s.sides.port.recording_seconds, 6.25);
assert.equal(s.sides.original.aligned_elapsed, 3);
assert.equal(s.sides.port.aligned_elapsed, 3.25);
assert.ok(Math.abs(s.eventDrift.seconds - 1.2) < 1e-9);
assert.equal(s.eventDrift.uncertainty_seconds, .05);
assert.equal(s.playbackDrift, .25);
});
test('no selected event means no invented drift', () => {
const {controller} = pair();
assert.equal(controller.snapshot().eventDrift, null);
assert.equal(controller.snapshot().playbackDrift, null);
});
test('exclusive soundtrack switch mutes both before selecting one', () => {
const {controller, original, port} = pair();
assert.ok(original.muted && port.muted);
controller.setAudio('original');
assert.ok(!original.muted && port.muted);
controller.setAudio('port');
assert.ok(original.muted && !port.muted);
controller.setAudio('none');
assert.ok(original.muted && port.muted);
assert.throws(() => controller.setAudio('external'));
});
test('gain is unadjusted by default and visibly review-only when changed', () => {
const {controller, original, port} = pair();
assert.equal(controller.snapshot().gain, 1);
assert.equal(controller.snapshot().gainAdjusted, false);
controller.setGain(.4);
assert.equal(original.volume, .4); assert.equal(port.volume, .4);
assert.equal(controller.snapshot().gainAdjusted, true);
assert.match(controller.snapshot().gainLabel, /review-only/i);
for (const value of [-1, 2, NaN]) assert.throws(() => controller.setGain(value));
});
test('buffering pauses both; explicit recovered play stays at rate one', async () => {
const {controller, original, port} = pair();
await controller.play(); port.readyState = 2; port.emit('waiting');
assert.ok(original.paused && port.paused);
assert.match(controller.snapshot().problem, /port.*buffer/i);
assert.equal(await controller.play(), false);
port.readyState = 4; port.emit('canplay');
assert.ok(original.paused && port.paused, 'readiness must not auto-resume');
assert.equal(await controller.play(), true);
assert.equal(port.playbackRate, 1);
});
test('decode failure is visible and blocks play', async () => {
const {controller, original, port} = pair();
port.error = {code: 3}; port.emit('error');
assert.ok(original.paused && port.paused);
assert.match(controller.snapshot().problem, /port.*decod/i);
assert.equal(await controller.play(), false);
});
test('missing media blocks pair but preserves manual available-side playback', async () => {
const port = new Media();
const controller = api.createPairController({original: null, port});
assert.equal(await controller.play(), false);
assert.match(controller.snapshot().problem, /missing/i);
assert.equal(await controller.playSide('port'), true);
assert.equal(controller.snapshot().sides.original.state, 'missing');
});
test('asymmetric end pauses pair and allows the complete longer tail', async () => {
const {controller, original, port} = pair();
await controller.play(); original.currentTime = original.duration; original.ended = true;
original.emit('ended');
assert.ok(port.paused);
assert.match(controller.snapshot().problem, /tail/i);
assert.equal(await controller.play(), true);
assert.equal(original.currentTime, 20); assert.ok(!port.paused);
port.currentTime = port.duration; port.ended = true; port.emit('ended');
assert.equal(await controller.play(), false);
});
test('manual play and seek never force the other recording to follow', async () => {
const {controller, original, port} = pair();
await controller.selectEvent(marker);
assert.equal(await controller.playSide('port'), true);
assert.ok(original.paused && !port.paused);
await controller.seekSide('port', 8);
assert.equal(original.currentTime, 2); assert.equal(port.currentTime, 8);
assert.ok(original.paused && port.paused);
});
test('external rate changes are corrected to actual speed without seeking', () => {
const {controller, original, port} = pair();
original.currentTime = 7; port.currentTime = 9;
port.playbackRate = 1.5; port.emit('ratechange');
assert.equal(port.playbackRate, 1);
assert.equal(port.currentTime, 9); assert.equal(original.currentTime, 7);
controller.pause();
});
test('event selection waits for asynchronous metadata and seek readiness', async () => {
const original = new Media(), port = new Media(); original.readyState = port.readyState = 0;
let t = 0;
Object.defineProperty(port, 'currentTime', {get: () => t, set: value => {
t = value; port.seeking = true;
setTimeout(() => {port.seeking = false; port.emit('seeked');}, 5);
}});
const controller = api.createPairController({original, port, timeoutMs: 100});
let finished = false;
const seek = controller.selectEvent(marker).then(() => {finished = true;});
await new Promise(resolve => setTimeout(resolve, 2));
assert.equal(finished, false); assert.equal(t, 0);
original.readyState = port.readyState = 4; original.emit('loadedmetadata'); port.emit('loadedmetadata');
await seek;
assert.equal(finished, true); assert.equal(port.currentTime, 3);
assert.ok(original.paused && port.paused);
});
test('seek timeout reports the cause and leaves pair paused', async () => {
const original = new Media(), port = new Media(); port.readyState = 0;
const controller = api.createPairController({original, port, timeoutMs: 10});
await assert.rejects(controller.selectEvent(marker), /readiness|metadata|timed out/i);
assert.match(controller.snapshot().problem, /readiness|metadata|timed out/i);
assert.ok(original.paused && port.paused);
});
test('buffering during a pending play cannot be erased by promise completion', async () => {
const {controller, original, port} = pair();
let release;
port.play = () => new Promise(resolve => { release = () => {port.paused = false; resolve();}; });
const playing = controller.play();
port.readyState = 2; port.emit('waiting'); release();
assert.equal(await playing, false);
assert.ok(original.paused && port.paused);
assert.match(controller.snapshot().problem, /buffer/i);
});
test('overlays start off and unsupported differences explain their gate', () => {
const {controller} = pair();
assert.deepEqual(controller.snapshot().overlays, {annotations: false, difference: false});
controller.setOverlay('annotations', true);
assert.equal(controller.snapshot().overlays.annotations, true);
assert.throws(() => controller.setOverlay('difference', true), /lossless|frame/i);
assert.equal(controller.snapshot().overlays.difference, false);
});
const frame = (sha = 'a'.repeat(64)) => ({url: 'sides/original/still.png', sha256: sha, size: 100,
frame: {lossless: true, event: 'landing', media_sha256: 'b'.repeat(64), media_seconds: 2,
viewport: [640, 480], crop: [0, 0, 640, 480], width: 640, height: 480}});
test('lossless differences need matched frame event viewport aspect and crop', () => {
assert.equal(typeof api.differenceEligibility, 'function');
const a = frame(), b = frame('c'.repeat(64));
assert.equal(api.differenceEligibility(a, b).eligible, true);
for (const patch of [{viewport: [800, 600]}, {crop: [1, 0, 639, 480]},
{event: 'jump'}, {lossless: false}, {media_sha256: null}]) {
const result = api.differenceEligibility(a, {...b, frame: {...b.frame, ...patch}});
assert.equal(result.eligible, false);
assert.ok(result.reason.length);
}
});
test('nonfinite elapsed or uncertainty is rejected before seeking', async () => {
const {controller, original} = pair();
for (const patch of [{elapsed_seconds: NaN}, {uncertainty_seconds: -1}])
await assert.rejects(controller.selectEvent({...marker, original: {...marker.original, ...patch}}));
assert.equal(original.currentTime, 0);
});
test('suite executes at least sixteen registered behavior tests', () => {
assert.ok(declared >= 16, 'runner must register at least sixteen tests');
});