Shaka Player在Safari浏览器中的Polyfill兼容性问题解析

问题背景

Shaka Player作为一款流行的开源HTML5视频播放器，在处理DRM加密内容时需要依赖浏览器的MediaCapabilities API。近期发现在Safari浏览器中，当项目使用NextJS 15.2.1及以上版本构建时，DRM内容无法正常播放，出现Shaka错误代码3010。

问题根源分析

这一问题源于Shaka Player中的MediaCapabilities polyfill实现与JavaScript引擎优化之间的微妙交互。具体表现为：

1. 原始实现机制：Shaka Player通过将navigator.mediaCapabilities存储在类属性originalMcap中，作为回退机制
2. 优化冲突：NextJS 15.2.1+使用的SWC编译器16+版本进行了合法的代码优化
3. GC行为变化：优化导致originalMcap引用被垃圾回收，破坏了polyfill的回退功能

技术细节

问题的核心在于JavaScript引擎对类属性处理的优化方式。当使用点表示法(originalMcap)时，编译器可能会进行属性名压缩优化；而使用方括号表示法(['originalMcap'])则能保持属性名不变，确保引用不被意外回收。

解决方案

经过验证，有两种可行的修复方案：

1. 属性声明优化：移除null初始赋值，仅保留属性声明

   shaka.polyfill.MediaCapabilities.originalMcap;
   

2. 引用方式调整：使用字符串属性名访问

   shaka.polyfill.MediaCapabilities['originalMcap'] = navigator.mediaCapabilities;
   

推荐采用第二种方案，因为：

• 更符合代码可读性原则
• 明确表达了属性访问意图
• 更容易添加解释性注释防止未来被"优化"

实现建议

在实际修复中，建议：

1. 使用方括号表示法保持属性引用
2. 添加详细注释说明这种特殊处理的原因
3. 记录相关优化背景，防止未来维护时被误改

总结

这类问题展示了前端开发中polyfill实现与编译器优化之间的微妙平衡。理解JavaScript引擎的优化行为对于编写可靠的跨浏览器兼容代码至关重要。Shaka Player团队通过这一修复，确保了在Safari浏览器中使用最新构建工具时的DRM内容播放稳定性。