You need to enable JavaScript to run this app. 能否通过编程方式获取生产环境用户实际加载的客户端bundle大小?
优惠活动
大模型
产品
解决方案
定价
更多

能否通过编程方式获取生产环境用户实际加载的客户端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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 19:54:05