Unit Tests

브라우저에서 실행되는 결정론적 수치·계약 테스트입니다. 별도 Node.js test runner가 필요하지 않습니다.

실행

가장 간단한 자동 실행은 저장소 루트의 test.cmd입니다. 임시 local server와 headless Edge/Chrome을 실행하고 결과에 맞는 process exit code를 반환합니다.

수동 확인은 start.cmd를 실행한 뒤 최신 Edge 또는 Chrome에서 http://127.0.0.1:4173/tests/을 열어 페이지 상단의 통과/실패 합계와 각 결과를 확인합니다.

Unit과 integration module은 같은 browser runner에서 순서대로 실행됩니다. 다시 실행하려면 페이지를 새로 고치세요. 다른 포트를 사용했다면 URL의 포트도 바꾸며, tests/index.html을 파일로 직접 열면 안 됩니다.

contracts.test.js: Array·Scene·Experiment·Result schema, algorithm·scale·beam-spread 관계 검증, 안전한 asset 경로와 이동 fixture
acoustics.test.js: seed 재현성, 자유음장 전파, trajectory 보간, sample 정렬 시간창과 tone/noise/asset 절대 시간 연속성, calibration, STFT, CPU DAS와 DAS-PHAT
gcc-phat.test.js: reference 선택, near-field lag 부호, 광대역 source peak, alias·메모리 선할당 제한, 0–1 score bound·scan 범위 불변성과 geometry/STFT/IFFT workspace 재사용
localization.test.js: 알고리즘 registry와 generic CPU/backend dispatcher, power/score 의미, portable GCC-PHAT block·streaming 경로
realtime-localizer.test.js: 기존 CPU DAS와 bit-exact map 동등성, chunk 경계 독립성, bounded ring/result batch, 취소와 geometry·steering cache 연산 절감
builder.test.js: Builder scene model, source/asset·trajectory 조작, 오디오 크기와 WAV 사전 검증
evaluation.test.js: local peak와 검출 감도, truth matching, energy/sidelobe/main-lobe 및 비확률적 beam-spread covariance ellipse
camera.test.js: canonical input hash, workload 추정, 이동 timeline 계획·재생 보간, Result schema 검증
webgpu.test.js: WGSL buffer packing, DAS-PHAT phase normalization, bin/point batching, 장치 한계와 typed CPU fallback 정책

WebGPU unit test 대부분은 실제 GPU 없이 planner와 binary layout을 검증합니다. 실제 GPU 수치 일치는 integration test에서 adapter가 있을 때 수행합니다.