通过向音频流 url 发起轻量级 fetch 请求并读取 http 响应头，可在不下载完整音频的前提下获取 content-type（如 audio/mpeg）和 icecast 自定义头 icy-br，从而实时显示音频格式与码率。
在 Web 广播播放场景中，原生
以下是一个健壮的模块化实现：
// ObtainStreamHeaders.js
export default function obtainStreamHeaders(src) {
return new Promise((resolve, reject) => {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), 5000); // 5秒超时保护
fetch(src, {
method: 'HEAD', // 优先使用 HEAD，避免传输响应体
signal: controller.signal,
headers: {
// 部分 Icecast 服务器需显式允许跨域头（若同源可省略）
'Accept': '*/*',
}
})
.then(response => {
clearTimeout(timeoutId);
const headers = Object.fromEntries(response.headers.entries());
resolve(headers);
})
.catch(err => {
clearTimeout(timeoutId);
reject(err.name === 'AbortError' ? new Error('Request timed out or aborted') : err);
});
});
}使用方式（配合播放器）：
Format: —Bitrate: —
import obtainStreamHeaders from './ObtainStreamHeaders.js';
const audio = document.getElementById('radio-player');
audio.addEventListener('playing', () => {
obtainStreamHeaders(audio.src)
.then(headers => {
// 解析 MIME 类型（标准化显示）
const mimeType = headers['content-type']?.split(';')[0].trim() || 'unknown';
const mimeLabel = {
'audio/mpeg': 'MP3',
'audio/ogg': 'OGG',
'audio/aac': 'AAC',
'audio/mp4': 'AAC (MP4)',
'audio/flac': 'FLAC'
}[mimeType] || mimeType;
document.getElementById('mime').textContent = mimeLabel;
// 解析 Icecast 码率（单位 kbps）
const br = headers['icy-br'] ? `${parseInt(headers['icy-br'], 10)} kbps` : 'unknown';
document.getElementById('br').textContent = br;
})
.catch(err => {
console.warn('Failed to fetch stream headers:', err);
document.getElementById('mime').textContent = 'unknown';
document.getElementById('br').textContent = 'unknown';
});
});
// 启动播放
audio.src = 'https://some-radio-station.com/stream';
audio.load(); // 显式调用 load() 确保 readyState 更新✅ 关键优化点说明：
- 使用 method: 'HEAD' 替代 GET，绝大多数流媒体服务器（包括 Icecast/Shoutcast）支持该方法，可完全避免数据体传输，显著降低延迟与带宽消耗；
- 添加 AbortController 超时机制（5 秒），防止因服务器无响应导致界面卡顿；
- Content-Type 值可能含参数（如 audio/mpeg; charset=binary），需 .split(';')[0] 提取主类型；
- icy-br 是 Icecast 专有响应头（非标准 HTTP），值为纯数字字符串（如 "128"），需转为整数再拼接单位；
- 注意 CORS 限制：若流服务未配置 Access-Control-Expose-Headers: icy-br, content-type，浏览器将屏蔽这些自定义头——此时需后端代理或联系广播站启用对应 CORS 头。
⚠️ 局限性提示：
- 不是所有广播服务都返回准确的 Content-Type（部分返回 audio/x-mpegurl 或 application/octet-stream）；
- icy-br 仅存在于 Icecast 服务器，Shoutcast v2+ 可能使用 icy-br: 或 X-Audio-Codec，需按实际响应调试；
- 纯 fetch 无法替代解码器探测（如区分 MP3 与 AAC 流），MIME 类型仍以服务端声明为准。
综上，该方案以最小侵入性实现了 Web 广播元信息的实时呈现，兼顾性能、兼容性与可维护性，是生产环境推荐实践。
