静态fallback不够,因浏览器按顺序选首个canPlayType()非空的即停,但该API返回“probably”“maybe”极不可靠;iOS Safari对type="audio/ogg"可能直接返回空字符串导致跳过不加载,且无报错;JS需补足错误监听、手势触发播放及格式实测兜底。

为什么只靠静态 fallback 还不够
浏览器按 DOM 顺序尝试 <source></source>,遇到第一个 canPlayType() 返回非空字符串的就停。但这个 API 返回值极不可靠:"probably" 不代表真能播,"maybe" 更是等于“我懒得验证”。尤其在 iOS Safari 上,它可能对 type="audio/ogg" 直接返回空字符串,哪怕文件实际是 Vorbis 编码——结果就是跳过、不加载、duration 为 NaN,控制台还一声不吭。
JS 的作用不是替代 fallback,而是补上三件事:确认哪个 source 真正加载失败、在用户手势后安全触发播放、捕获并区分错误类型。
-
audio.addEventListener('error', () => console.warn('source load failed:', audio.error?.code))—— 必须监听,否则你永远不知道是跨域、格式不支持,还是网络中断 - 不要在
canplay或loadeddata里调play(),iOS 不认这种“伪手动”上下文 - 多个 audio 元素需各自预激活:
audio.play().then(() => audio.pause()),iOS 不共享手势授权状态
如何用 JS 判断当前浏览器真正支持哪种格式
别信 canPlayType() 的模糊返回,直接试加载 + 超时兜底。核心逻辑是:按优先级顺序逐个尝试 <source></source>,每个设独立 error 和 canplay 监听,500ms 内没触发 canplay 就切下一个。
示例关键片段:
立即学习“前端免费学习笔记(深入)”;
const sources = [
{ src: 'sound.mp3', type: 'audio/mpeg' },
{ src: 'sound.opus', type: 'audio/opus' },
{ src: 'sound.wav', type: 'audio/wav' }
];
let currentSourceIndex = 0;
function tryNextSource() {
if (currentSourceIndex >= sources.length) return;
const { src, type } = sources[currentSourceIndex];
audio.innerHTML = `<source src="${src}" type="${type}">`;
const timeout = setTimeout(() => {
currentSourceIndex++;
tryNextSource();
}, 500);
audio.addEventListener('canplay', () => clearTimeout(timeout), { once: true });
audio.addEventListener('error', () => {
currentSourceIndex++;
tryNextSource();
});
}
注意:此法仅用于 fallback 失效后的兜底探测,不能替代静态 <source></source> 声明——因为首次加载仍依赖浏览器原生解析流程。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
JS 播放必须带 .catch() 并区分 NotAllowedError 和 NotSupportedError
audio.play() 返回 Promise,不 .catch() 就等于放弃诊断权。现代浏览器拒绝播放时,错误名直接暴露问题根源:
-
NotAllowedError:用户没点过页面,或muted属性缺失,或微信环境未等WeixinJSBridgeReady -
NotSupportedError:所有<source></source>都被跳过,大概率是服务器Content-Type错了,或编码不被支持(如 Firefox 对 VBR MP3 解码卡住) -
AbortError:网络中断、跨域请求被拦截、或音频文件损坏
可靠写法:
button.addEventListener('click', () => {
audio.play()
.catch(e => {
if (e.name === 'NotAllowedError') {
console.warn('iOS/WeChat: need user gesture');
} else if (e.name === 'NotSupportedError') {
console.warn('No playable source found — check MIME & encoding');
}
});
});
跨域音频必须走代理 + 手势 + 错误捕获三重保障
直接 src="https://cdn.example.com/sound.mp3" 在 iOS Safari 和微信 WebView 中必然静默失败:networkState 为 0,duration 是 NaN,控制台无任何提示。这不是 JS 能绕过的。
唯一路径是后端代理 + 前端三重校验:
- 代理响应头必须含
Content-Type: audio/mpeg和Access-Control-Allow-Origin: *(避免 302 重定向,否则 CORS 头丢失) - 前端仍要绑定用户手势:
document.body.addEventListener('touchstart', initAudio, { once: true }) - 必须监听
error事件和play().catch(),因为即使代理成功,iOS 也可能因未获手势授权而拒播
最容易被忽略的是:跨域音频在 iOS 上首次播放失败后,后续即使用户点了按钮,play() 仍可能被拒——WebKit 的音频上下文锁定是会话级的,必须确保第一次调用就在合法手势回调内。


















