Files
gods-eye-view/src/ui/radioPanel.test.mjs
T
Sameh Khamis d98a7c81be feat(kit): render the pressed toggles with UiButton
UiButton gains pressedClass, Core's class on a pressed button. The pressed
classes toggle through classList, so classes other code adds survive a
press, a caller's class change keeps them, a renamed pressedClass leaves
the button, and server-rendered markup carries them.

The Display, SDR, Radio and Cockpit enable, Cockpit weather and briefing,
mission replay, Street Level, TR-3B, overlay, voice and CCTV toggles now
render through it with the same ids, classes and aria-pressed values.
2026-11-01 11:59:30 -08:00

369 lines
14 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// src/ui/radioPanel.test.mjs — the Radio panel renders what RadioControls
// presents (`renderRadioState()`), over happy-dom.
import '../testSupport/registerDom.mjs';
import test from 'node:test';
import assert from 'node:assert/strict';
import { createPinia } from 'pinia';
import { createApp, nextTick } from 'vue';
import { useRadioStore } from './stores/radio.js';
import RadioPanel from './views/panels/RadioPanel.vue';
import {
renderRadioState,
showRadioEnableBusy,
showRadioVolume,
} from './radioPresentation.js';
import { setLocale } from '../i18n/index.js';
import { LocalSdrControls } from './localSdrControls.js';
// Core's classes on an element, without the kit's `ui-` classes.
const coreClasses = (el) =>
[...el.classList].filter((name) => !name.startsWith('ui-')).join(' ');
function fixture(t) {
document.body.replaceChildren();
const host = document.body.appendChild(document.createElement('div'));
const pinia = createPinia();
const app = createApp(RadioPanel).use(pinia);
app.mount(host);
t.after(() => app.unmount());
const $ = (id) => document.getElementById(id);
let lifecycle = null;
const owner = {
destroyed: false,
store: useRadioStore(pinia),
_radioPanel: $('radio-panel'),
_radioVolume: $('radio-volume'),
actions: {
getLifecycle: () => lifecycle,
preservePanelStateDuringClear: () => true,
setPanelCollapsed() {},
scheduleLayout() {},
},
};
const render = async (state) => {
renderRadioState.call(owner, {
enabled: true,
categories: [
{ id: 'all', label: 'All', count: 3, color: '' },
{ id: 'jazz', label: 'Jazz', count: 1, color: '#ffb547' },
],
filter: 'all',
filteredCount: 3,
stationCount: 3,
volume: 0.8,
audioState: 'stopped',
...state,
});
await nextTick();
};
const setLifecycle = (next) => (lifecycle = next);
return { $, owner, render, setLifecycle };
}
test('before RadioControls renders, the panel shows its initial markup', (t) => {
const { $ } = fixture(t);
assert.equal($('radio-layer-state').textContent, 'OFF');
assert.equal($('radio-enable-btn').textContent, 'ENABLE');
assert.equal($('radio-enable-btn').hasAttribute('aria-busy'), false);
assert.equal($('radio-filter').disabled, true);
assert.equal($('radio-filter').options.length, 1);
assert.equal($('radio-filter').options[0].value, 'all');
assert.equal($('radio-filter').options[0].textContent, 'All');
assert.equal($('radio-play-btn').getAttribute('class'), null);
assert.equal($('radio-play-btn').disabled, true);
assert.equal($('radio-volume').value, '80');
assert.equal($('radio-volume-value').textContent, '80%');
assert.equal($('radio-playback-state').textContent, 'Radio off');
assert.equal($('radio-station-homepage').getAttribute('href'), '#');
assert.equal($('radio-station-homepage').hidden, true);
});
test('the panel renders the presented directory, station, transport and playback', async (t) => {
const { $, render } = fixture(t);
const panel = $('radio-panel');
await render({
selected: {
name: 'KJAZ',
state: 'Texas',
countryCode: 'US',
codec: 'MP3',
bitrate: 128,
tags: ['jazz', 'blues'],
homepage: 'https://example.org/',
},
selectedIndex: 0,
audioState: 'playing',
filter: 'jazz',
});
assert.equal(panel.classList.contains('radio-enabled'), true);
assert.equal(panel.classList.contains('collapsed'), true, 'chrome keeps its class');
assert.equal($('radio-layer-state').className, 'radio-layer-state active');
assert.equal($('radio-layer-state').textContent, '3/3');
const enable = $('radio-enable-btn');
assert.equal(coreClasses(enable), 'panel-layer-toggle active');
assert.equal(enable.textContent, 'DISABLE');
assert.equal(enable.getAttribute('aria-pressed'), 'true');
assert.equal(enable.getAttribute('aria-label'), 'Disable Radio');
assert.equal(enable.getAttribute('aria-busy'), 'false');
const filter = $('radio-filter');
const [all, jazz] = filter.options;
assert.equal(filter.options.length, 2);
assert.equal(jazz.textContent, '● Jazz (1)');
assert.equal(jazz.getAttribute('aria-label'), 'Jazz (1)');
assert.equal(jazz.dataset.radioColor, '#ffb547');
assert.equal(all.getAttribute('aria-label'), 'All (3)');
assert.equal(filter.value, 'jazz');
assert.equal(filter.disabled, false);
assert.ok(filter.style.color);
assert.equal($('radio-station-name').textContent, 'KJAZ');
assert.equal($('radio-station-meta').textContent, 'Texas · US / MP3 · 128 kbps');
assert.equal($('radio-station-tags').textContent, 'TAGS · jazz · blues');
assert.equal($('radio-station-homepage').getAttribute('href'), 'https://example.org/');
assert.equal($('radio-station-homepage').hidden, false);
const play = $('radio-play-btn');
assert.equal(play.className, 'active');
assert.equal(play.textContent, 'PAUSE');
assert.equal(play.getAttribute('aria-label'), 'Pause selected radio station');
assert.equal($('radio-prev-btn').disabled, false);
assert.equal($('radio-stop-btn').disabled, false);
assert.equal($('radio-playback-state').textContent, 'Playing KJAZ');
await render({ audioState: 'error', filter: 'all' });
assert.equal(play.className, '');
assert.equal($('radio-playback-state').className, 'radio-playback-state error');
assert.equal($('radio-station-homepage').hasAttribute('href'), false);
assert.equal($('radio-station-homepage').hidden, true);
assert.equal(filter.getAttribute('style'), null);
});
test('the markup’s tag option stands until the categories first change', async (t) => {
const { $, render } = fixture(t);
await render({ enabled: false, categories: [], filteredCount: 0, stationCount: 0 });
const filter = $('radio-filter');
assert.equal(filter.options.length, 1);
assert.equal(filter.options[0].textContent, 'All');
await render({});
assert.equal(filter.options.length, 2);
await render({ categories: [] });
assert.equal(filter.options.length, 0, 'categories that empty clear the list');
});
test('a render puts back the published tag after a refused pick', async (t) => {
const { $, render } = fixture(t);
await render({});
const filter = $('radio-filter');
filter.value = 'jazz';
await render({});
assert.equal(filter.value, 'all');
});
test('a volume the person is dragging is not rewritten; its readout follows the drag', async (t) => {
const { $, owner, render } = fixture(t);
await render({ volume: 0.5 });
const volume = $('radio-volume');
assert.equal(volume.value, '50');
volume.focus();
volume.value = '30';
showRadioVolume.call(owner, 30);
await nextTick();
assert.equal($('radio-volume-value').textContent, '30%');
await render({ volume: 0.9 });
assert.equal(volume.value, '30');
assert.equal($('radio-volume-value').textContent, '30%');
volume.blur();
await render({ volume: 0.9 });
assert.equal(volume.value, '90');
assert.equal($('radio-volume-value').textContent, '90%');
});
test('a Radio lifecycle in transition marks Enable busy without disabling it', async (t) => {
const { $, render, setLifecycle } = fixture(t);
setLifecycle({ lifecycleState: 'enabling', enabled: false, uncertain: false });
await render({});
const enable = $('radio-enable-btn');
assert.equal(enable.textContent, 'ENABLING');
assert.equal(enable.getAttribute('aria-busy'), 'true');
assert.equal(enable.getAttribute('aria-disabled'), 'true');
assert.equal(enable.disabled, false);
assert.equal($('radio-layer-state').textContent, 'ENABLING');
assert.equal($('radio-playback-state').textContent, 'Radio is enabling…');
setLifecycle({ lifecycleState: 'enabled', enabled: true, uncertain: true });
await render({});
assert.equal(enable.textContent, 'RECONCILE');
assert.equal(enable.getAttribute('aria-busy'), 'false');
assert.equal($('radio-panel').classList.contains('lifecycle-uncertain'), true);
assert.equal($('radio-playback-state').className, 'radio-playback-state error');
});
test('tag options show localized text and names', async (t) => {
const { $, render } = fixture(t);
setLocale('zh-CN');
t.after(() => setLocale('en'));
await render({ categories: [{ id: 'all', label: '全部', count: 750, color: '' }] });
const [option] = $('radio-filter').options;
assert.equal(option.textContent, '● 全部(750)');
assert.equal(option.getAttribute('aria-label'), '全部(750)');
});
test('a toggle that ends mid-transition does not leave Enable marked idle', async (t) => {
const { $, owner, render, setLifecycle } = fixture(t);
await render({});
const enable = $('radio-enable-btn');
showRadioEnableBusy.call(owner, true);
await nextTick();
assert.equal(enable.getAttribute('aria-busy'), 'true');
setLifecycle({ lifecycleState: 'enabling', enabled: false, uncertain: false });
await render({});
// The toggle was refused while the lifecycle is still enabling.
showRadioEnableBusy.call(owner, false);
await nextTick();
assert.equal(enable.getAttribute('aria-busy'), 'false');
await render({});
assert.equal(enable.getAttribute('aria-busy'), 'true', 'the next render reports it');
assert.equal(enable.getAttribute('aria-disabled'), 'true');
});
function sdrReceiver() {
const listeners = new Set();
let state = {
webUsbSupported: true,
connected: false,
status: 'idle',
message: 'Connect an RTL-SDR to begin.',
mode: 'fm',
frequencyHz: 98_500_000,
volume: 0.8,
gain: 'auto',
locationStatus: 'unknown',
};
return {
volumes: [],
getState: () => ({ ...state }),
subscribe(listener) {
listeners.add(listener);
return () => listeners.delete(listener);
},
emit(patch) {
state = { ...state, ...patch };
for (const listener of listeners) listener({ ...state });
},
setVolume(value) {
this.volumes.push(value);
},
};
}
test('the RTL-SDR card renders what LocalSdrControls presents', async (t) => {
const { $, owner } = fixture(t);
const receiver = sdrReceiver();
const controls = new LocalSdrControls({ document, receiver, store: owner.store });
t.after(() => controls.destroy());
const frame = () => new Promise((resolve) => setTimeout(resolve, 40));
await nextTick();
assert.equal($('sdr-connection-state').getAttribute('class'), null);
assert.equal($('sdr-connect-btn').textContent, 'CONNECT');
assert.equal($('sdr-connect-btn').disabled, false);
assert.equal(coreClasses($('sdr-mode-fm-btn')), 'active');
assert.equal($('sdr-mode-adsb-btn').getAttribute('aria-pressed'), 'false');
assert.equal($('sdr-adsb-stats').hidden, true);
assert.equal($('sdr-frequency-input').value, '98.5');
assert.equal($('sdr-feed-status').hidden, true);
receiver.emit({
connected: true,
status: 'streaming',
mode: 'adsb',
gain: 20.7,
aircraftHeard: 3,
aircraftPositioned: 2,
messagesPerSecond: 41.25,
});
await frame();
const panel = $('radio-panel');
assert.equal(panel.classList.contains('sdr-connected'), true);
assert.equal(panel.classList.contains('collapsed'), true, 'chrome keeps its class');
assert.equal($('sdr-connection-state').className, 'active');
assert.equal($('sdr-connect-btn').textContent, 'DISCONNECT');
assert.equal(coreClasses($('sdr-connect-btn')), 'panel-layer-toggle active');
assert.equal(coreClasses($('sdr-mode-fm-btn')), '');
assert.equal(coreClasses($('sdr-mode-adsb-btn')), 'active');
assert.equal($('sdr-adsb-stats').hidden, false);
assert.equal($('sdr-stat-heard').textContent, '3');
assert.equal($('sdr-stat-positioned').textContent, '2');
assert.equal($('sdr-gain-select').value, '20.7');
assert.equal($('sdr-frequency-input').disabled, true);
// A focused field keeps the value the person is setting (FM volume).
receiver.emit({ mode: 'fm' });
await frame();
const volume = $('sdr-volume');
assert.equal(volume.disabled, false);
volume.focus();
volume.value = '35';
volume.dispatchEvent(new Event('input'));
await nextTick();
assert.deepEqual(receiver.volumes, [0.35]);
assert.equal($('sdr-volume-value').textContent, '35%');
receiver.emit({ volume: 0.6 });
await frame();
assert.equal(volume.value, '35');
volume.blur();
receiver.emit({ volume: 0.6, connected: false, status: 'idle' });
await frame();
assert.equal(volume.value, '60');
assert.equal($('sdr-volume-value').textContent, '60%');
assert.equal(panel.classList.contains('sdr-connected'), false);
});
test('focused RTL-SDR fields keep what the person typed or picked', async (t) => {
const { $, owner, render } = fixture(t);
const receiver = sdrReceiver();
let feeds = { configured: null, polling: false, feeds: [] };
const feedListeners = new Set();
const controls = new LocalSdrControls({
document,
receiver,
store: owner.store,
feeds: {
getState: () => feeds,
subscribe(listener) {
feedListeners.add(listener);
return () => feedListeners.delete(listener);
},
probe: async () => {},
},
});
t.after(() => controls.destroy());
const frame = () => new Promise((resolve) => setTimeout(resolve, 40));
receiver.emit({ connected: true, status: 'streaming' });
await frame();
const frequency = $('sdr-frequency-input');
frequency.focus();
frequency.value = '101.1';
receiver.emit({ frequencyHz: 98_700_000 });
await frame();
assert.equal(frequency.value, '101.1', 'typing is not undone');
await render({});
assert.equal(frequency.value, '101.1', 'nor by a Radio render');
frequency.blur();
receiver.emit({ frequencyHz: 98_700_000 });
await frame();
assert.equal(frequency.value, '98.7');
const gain = $('sdr-gain-select');
gain.focus();
gain.value = '20.7';
receiver.emit({ gain: 'auto' });
await frame();
assert.equal(gain.value, '20.7', 'the pick stands while focused');
feeds = {
configured: true,
polling: true,
feeds: [{ band: '1090', status: 'live' }],
};
for (const listener of feedListeners) listener(feeds);
await frame();
assert.equal($('sdr-feed-status').hidden, false);
assert.equal($('sdr-feed-status').textContent, 'Decoder feeds: 1090 live');
});