能否通过编程方式获取生产环境用户实际加载的客户端bundle大小?
可获取已加载客户端Bundle大小的浏览器API实现方案
核心可用能力:Resource Timing API
这是目前全主流浏览器稳定支持的标准能力,完全可以满足你追踪生产环境实际下载bundle大小的监控需求:
- 覆盖范围:Chrome 43+、Firefox 39+、Safari 10.1+、Edge 全部稳定版本,不需要依赖实验性flag,生产环境可用性远高于“仅一两个浏览器支持”的预期
- 可直接获取的核心指标:
transferSize:资源实际通过网络传输的总字节数,包含HTTP协议头开销,如果资源是从浏览器本地缓存命中的,这个值会返回0,刚好能匹配你“用户实际需下载大小”的统计目标encodedBodySize:资源压缩后的响应体字节长度,不包含HTTP头,哪怕缓存命中也能正常返回数值decodedBodySize:资源经过解压、解码后的原始字节长度,也就是你构建产物源码层面的实际体积
- 数据获取范围:只要是当前会话中已经完成加载的资源,不管是页面初始加载时同步拉取的,还是后续运行时动态加载的历史bundle,只要资源时序缓存没有被清除,都可以通过该API拿到数值
实际采集代码示例
// 获取当前会话所有已加载的脚本类资源(即我们常说的JS bundle) const loadedResources = performance.getEntriesByType('resource'); const jsBundles = loadedResources.filter(resource => resource.initiatorType === 'script'); // 遍历提取每个bundle的大小指标,直接上报到监控系统即可 jsBundles.forEach(bundle => { const metrics = { url: bundle.name, actualDownloadSize: bundle.transferSize, compressedBodySize: bundle.encodedBodySize, decodedSize: bundle.decodedBodySize } // 这里替换成你自己的监控上报逻辑 console.log('采集到bundle指标:', metrics) })
采集注意事项
- 跨域加载的静态资源如果没有在响应头中配置
Timing-Allow-Origin允许你的监控采集域名,浏览器会出于隐私保护,把上述三个大小字段全部置为0,这种情况需要在静态资源服务端补充对应响应头配置,才能拿到真实的数值 - 如果需要统计的是还未被用户实际加载、仅做了预连接/预加载占位的bundle,这个API是无法拿到对应数值的,这类场景需要在构建阶段输出bundle大小的元数据清单,在资源实际加载完成后匹配对应记录上报
补充:如果你的bundle还包含CSS文件,只需要把上面代码中的
initiatorType过滤条件从script改成css,就可以同步采集CSS资源的实际下载大小。
内容的提问来源于stack exchange,提问作者Florian Bienefelt
相关产品推荐
相关产品推荐

