File.prototype.stream() 和 ReadableStream.getReader()的浏览器兼容性如何？

File.prototype.stream() 和 ReadableStream.getReader()，这是现代 Web Streams API 的一部分。

虽然功能强大（支持流式处理大文件、低内存占用），但它的浏览器兼容性比 file.arrayBuffer() 更晚，需谨慎评估目标环境。

---

✅ 浏览器兼容性（截至 2026 年）

浏览器	支持 file.stream() 的起始版本	备注
Chrome	≥ 85	2020 年 8 月起支持
Edge	≥ 85	基于 Chromium，同步支持
Firefox	≥ 102	2022 年 6 月起支持（较晚！）
Safari	≥ 14.1	macOS 11.3+ / iOS 14.5+（2021 年 4 月）
iOS Safari	≥ 14.5	同上
Android WebView / Chrome for Android	≥ 85	大多数现代设备已支持
Opera	≥ 71	与 Chrome 同步

❌ 完全不支持：

• Internet Explorer（所有版本）
• Safari ≤ 14.0
• Firefox ≤ 101（注意：Firefox 支持明显滞后）

---

📊 全球兼容性覆盖率（参考 caniuse: blob stream）

• 综合支持率：约 90%~93%（2026 年初）
• 主要缺口：
  • Firefox 用户：如果你的用户中有较多 Firefox 用户（尤其企业或开发者群体），需特别注意 —— Firefox 102 之前完全不支持。
  • 旧版 iOS（<14.5）：在部分新兴市场仍有少量设备。

---

🔧 安全使用建议：特性检测 + 降级方案

由于兼容性不如 arrayBuffer()，强烈建议做特性检测，并在不支持时回退到 FileReader 或 arrayBuffer()：

async function processFileWithStream(file) {
  // 检查是否支持 .stream()
  if (typeof file.stream !== 'function') {
    // 降级：一次性读取整个文件
    const buffer = await readFileAsArrayBuffer(file); // 使用前面提到的兼容函数
    processChunk(new Uint8Array(buffer));
    return;
  }

  const stream = file.stream();
  const reader = stream.getReader();

  try {
    while (true) {
      const { done, value } = await reader.read();
      if (done) break;
      processChunk(value); // value 是 Uint8Array
    }
  } finally {
    reader.releaseLock(); // 重要：释放流锁
  }
}

⚠️ 注意：务必调用 reader.releaseLock()，否则可能导致资源未释放（尤其在中途退出时）。

---

🆚 对比其他读取方式的兼容性（从高到低）

方法	兼容性（广度）	适用场景
FileReader.readAsArrayBuffer()	⭐⭐⭐⭐⭐（IE10+）	最广泛兼容
file.arrayBuffer()	⭐⭐⭐⭐（Chrome 76+, Safari 14.1+, FF 69+）	现代项目首选
file.text() / file.slice()	与 arrayBuffer() 相近	文本/分片处理
file.stream()	⭐⭐⭐（Firefox 102+ 是关键门槛）	流式处理大文件、低内存场景

---

✅ 最佳实践总结

1. 仅在需要流式处理时使用 .stream()
   如果只是读取小文件，用 file.arrayBuffer() 更简单、兼容性更好。

2. 必须做特性检测
   不要假设所有现代浏览器都支持（尤其是 Firefox 用户可能还在旧版）。

3. 记得 releaseLock()
   避免潜在的内存或流锁定问题。

4. 监控用户浏览器分布
   如果你的产品数据显示 Firefox < 102 占比 > 1%，建议暂缓使用或提供完整降级。

---

💡 补充：未来趋势

• Web Streams API 是 W3C 标准，长期看会成为主流。
• 但目前（2026 年）在要求广泛兼容的生产环境中，仍需谨慎使用 file.stream()。