sonda/web/src/player/volume.test.ts
tgiachi 394208de75 feat(web): volume and mute in the player state, remembered in the browser
The level is kept while muted so unmuting brings it back, moving it unmutes, pressing mute on silence raises it instead of doing nothing, and a browser that refuses storage just forgets it.
2026-11-12 15:21:41 +01:00

91 lines
3.5 KiB
TypeScript

import { afterEach, beforeEach, expect, test, vi } from 'vitest'
import { usePlayer } from './store'
import { loadVolume, saveVolume } from './volume'
const KEY = 'sonda.volume'
beforeEach(() => {
localStorage.clear()
usePlayer.setState({ volume: 1, muted: false })
})
afterEach(() => vi.restoreAllMocks())
// --- what is remembered in the browser --------------------------------------------------------
test('with nothing remembered the volume is full and not muted', () => {
expect(loadVolume()).toEqual({ volume: 1, muted: false })
})
test('what was saved is read back', () => {
saveVolume({ volume: 0.4, muted: true })
expect(loadVolume()).toEqual({ volume: 0.4, muted: true })
})
test.each([
['not JSON', 'nope'],
['not an object', '3'],
['a volume that is not a number', '{"volume":"loud","muted":false}'],
['a volume above 1', '{"volume":7,"muted":false}'],
['a negative volume', '{"volume":-1,"muted":false}'],
['a mute that is not a boolean', '{"volume":0.5,"muted":"yes"}'],
])('%s is ignored and the defaults are used', (_what, stored) => {
localStorage.setItem(KEY, stored)
expect(loadVolume()).toEqual({ volume: 1, muted: false })
})
test('a browser that refuses to read or write storage does not break the player', () => {
vi.spyOn(Storage.prototype, 'getItem').mockImplementation(() => {
throw new Error('blocked')
})
vi.spyOn(Storage.prototype, 'setItem').mockImplementation(() => {
throw new Error('blocked')
})
expect(loadVolume()).toEqual({ volume: 1, muted: false })
expect(() => saveVolume({ volume: 0.2, muted: false })).not.toThrow()
expect(() => usePlayer.getState().setVolume(0.3)).not.toThrow()
})
// --- the rules of volume and mute ------------------------------------------------------------
test('setting the volume keeps it and remembers it', () => {
usePlayer.getState().setVolume(0.35)
expect(usePlayer.getState().volume).toBe(0.35)
expect(JSON.parse(localStorage.getItem(KEY) ?? '{}')).toEqual({ volume: 0.35, muted: false })
})
test('a volume outside 0 to 1 is brought back into it, and a number that is not one is ignored', () => {
usePlayer.getState().setVolume(2)
expect(usePlayer.getState().volume).toBe(1)
usePlayer.getState().setVolume(-0.5)
expect(usePlayer.getState().volume).toBe(0)
usePlayer.getState().setVolume(0.6)
usePlayer.getState().setVolume(Number.NaN)
expect(usePlayer.getState().volume).toBe(0.6)
})
test('moving the volume while muted unmutes', () => {
usePlayer.setState({ muted: true, volume: 0.5 })
usePlayer.getState().setVolume(0.7)
expect(usePlayer.getState()).toMatchObject({ volume: 0.7, muted: false })
})
test('mute keeps the level, and unmute brings it back', () => {
usePlayer.setState({ volume: 0.8, muted: false })
usePlayer.getState().toggleMute()
expect(usePlayer.getState()).toMatchObject({ volume: 0.8, muted: true })
expect(JSON.parse(localStorage.getItem(KEY) ?? '{}')).toEqual({ volume: 0.8, muted: true })
usePlayer.getState().toggleMute()
expect(usePlayer.getState()).toMatchObject({ volume: 0.8, muted: false })
})
test('pressing mute on a volume that is already zero raises it instead, so the button never does nothing', () => {
usePlayer.setState({ volume: 0, muted: false })
usePlayer.getState().toggleMute()
expect(usePlayer.getState()).toMatchObject({ volume: 0.5, muted: false })
})
test('unmuting a volume that was dragged to zero while muted restores a level too', () => {
usePlayer.setState({ volume: 0, muted: true })
usePlayer.getState().toggleMute()
expect(usePlayer.getState()).toMatchObject({ volume: 0.5, muted: false })
})