JavaScript单元测试中Mock AudioContext的关键是替换或拦截原型方法并控制返回值与调用时机，推荐用jest.spyOn或jest.mock模拟decodeAudioData等方法，返回Promise形式的AudioBuffer或拒绝态以覆盖成功/失败路径，并在beforeEach中清理mock。
在 JavaScript 单元测试中，Mock AudioContext（尤其是其音频解码行为，如 decodeAudioData）的关键是**替换或拦截原型方法，并控制返回值与调用时机**，避免真实音频处理干扰测试环境。由于 AudioContext 是浏览器原生 API，不能直接实例化 mock 对象，推荐通过 Jest（或其他测试框架）的 jest.mock 或 jest.spyOn 实现。
1. Mock decodeAudioData 方法（最常用场景）
多数测试关注的是解码逻辑是否被正确调用、是否处理了成功/失败回调。可直接 spyOn AudioContext.prototype.decodeAudioData：
- 用
jest.fn()替换它，返回 Promise 模拟成功或拒绝 - 确保返回一个符合 Web Audio API 签名的
AudioBuffer（可用new AudioBuffer({ length: 1, sampleRate: 44100 })快速构造） - 注意：必须在测试前执行 spy，且建议在
beforeEach中清理（mockClear()或mockRestore()）
示例：
beforeEach(() => {
global.AudioContext = jest.fn().mockImplementation(() => ({
decodeAudioData: jest.fn().mockResolvedValue(
new AudioBuffer({ length: 44100, sampleRate: 44100 })
),
createBufferSource: jest.fn(),
// 其他需用到的方法可按需补充
}));
});
test('should decode audio and play', async () => {
const ctx = new AudioContext();
const buffer = await ctx.decodeAudioData(new ArrayBuffer(0));
expect(buffer).toBeInstanceOf(AudioBuffer);
expect(ctx.decodeAudioData).toHaveBeenCalledTimes(1);
});
2. 模拟解码失败（测试错误处理）
真实解码可能因格式错误、损坏数据等失败。可通过 mock 返回 rejected Promise 来覆盖异常路径：
立即学习“Java免费学习笔记（深入）”；
- 使用
mockRejectedValue(new Error('Decoding failed')) - 若代码使用传统回调（
decodeAudioData(arrayBuffer, successCb, errorCb)），需分别 mock 成功/失败回调调用（注意：现代标准已废弃回调形式，优先用 Promise） - 确保测试中
await或.catch()覆盖了错误分支
3. 全局 AudioContext 构造函数级 Mock（更彻底）
如果测试涉及多次 new AudioContext()，或需要统一控制所有上下文行为，可 mock 整个构造函数：
- 用
jest.mock('path-to-your-module', () => {...})不适用，因为AudioContext是全局对象；应直接重赋值global.AudioContext - 可封装一个“可控 AudioContext”类，暴露
setDecodeResult方法，便于不同测试用例切换行为 - 注意：Node.js 环境无原生
AudioContext，若在 Jest 的 jsdom 环境中运行，该 mock 本身已是必需步骤
4. 注意事项与兼容性
部分旧版浏览器或测试环境（如 jsdom ≤ 16）不实现 AudioContext，需确保 polyfill 或显式 mock；另外：
-
OfflineAudioContext同样需要单独 mock（如用于渲染测试） - 避免在 mock 中调用真实音频方法（如
createBufferSource()），除非你也在 mock 它们 - Jest 27+ 支持自动 mock 全局构造器，但手动控制更可靠
