Stats 字段参考

mf-stats.json 是启用 manifest 后生成的构建统计文件,包含本次构建的 exposes/shared/remotes 资源信息、metaData(构建信息、remoteEntry 等)以及资产分析结果。

本文按字段解释 mf-stats.json 的���构,便于排查「线上到底加载了哪些资源」、「某个 shared 在哪些地方被用到」、「remoteEntry 的类型/地址是什么」等问题。

顶层结构

字段类型必有说明
idstring是本次构建的唯一标识
namestring是federation name
metaDataStatsMetaData是构建与远程入口信息
sharedStatsShared[]是shared 依赖列表(包含版本、资源与使用信息)
remotesStatsRemote[]是remotes 列表(包含 entry/version 以及消费关系)
exposesStatsExpose[]是exposes 列表(包含资源与依赖信息)

metaData(两者都有)

metaData 描述“这个构建产物怎么被消费端加载”以及“本次构建的上下文信息”。mf-stats.json 与 mf-manifest.json 都包含该字段。

StatsMetaData

StatsMetaData 有两种互斥形态(只会出现一种):

  • 函数形式:getPublicPath: string
  • 字符串形式:publicPath: string(可选 ssrPublicPath: string)

共同字段如下:

字段类型必有说明
namestring是当前 remote/host 名称
globalNamestring是remoteEntry 对应的 globalName
buildInfoStatsBuildInfo是构建信息(版本/构建名等)
remoteEntryResourceInfo是remoteEntry 资源信息
ssrRemoteEntryResourceInfo否SSR remoteEntry(若有)
typesMetaDataTypes否类型产物信息(若有)
typestring是APP、NPM
pluginVersionstring否MF 构建插件版本

ResourceInfo

字段类型必有说明
pathstring是构建产物内路径(相对路径)
namestring是文件名
typeRemoteEntryType是remoteEntry 的输出格式(例如 var/umd/system/...)

StatsBuildInfo

字段类型必有说明
buildVersionstring是构建版本
buildNamestring是构建名
targetstring[]否target 列表
pluginsstring[]否treeShaking 插件列表
excludePluginsstring[]否treeShaking 排除插件列表

MetaDataTypes

字段类型必有说明
pathstring是产物路径
namestring是文件名(旧版类型需要,即将废弃)
apistring是API 类型入口
zipstring是zip 包地址/路径

assets(两者都有)

StatsAssets 描述某个条目(shared/expose)的同步/异步资源列表。mf-stats.json 与 mf-manifest.json 都会用到该结构。

StatsAssets

字段类型必有说明
jsStatsAssetsInfo是JS 资源
cssStatsAssetsInfo是CSS 资源

StatsAssetsInfo

字段类型必有说明
syncstring[]是初始加载资源
asyncstring[]是异步加载资源

shared

StatsShared

字段类型必有说明
idstring是shared 唯一 id
namestring是包名
versionstring是本次构建使用的版本
singletonboolean是是否 singleton
requiredVersionstring是requiredVersion
hashstring是内容 hash
assetsStatsAssets是资源列表
depsstring[]是依赖列表
usedInstring[]是被哪些模块/容器使用
usedExportsstring[]是实际使用到的导出
fallbackstring是treeshaking fallback 路径/标识
fallbackNamestring是treeshaking fallback 名称
fallbackTypeRemoteEntryType是treeshaking fallback 产物类型

remotes

StatsRemote 是 “remote 的消费关系” 记录:包含它的 entry 或 version(二选一),以及它在当前构建里是如何被消费的。

StatsRemoteVal(共同字段)

字段类型必有说明
moduleNamestring是remote 模块名
federationContainerNamestring是remote 容器名
consumingFederationContainerNamestring是消费端容器名
aliasstring是alias
usedInstring[]是被哪些模块/容器使用

StatsRemote(互斥字段)

  • entry: string(存在时不会有 version)
  • version: string(存在时不会有 entry)

exposes

StatsExpose

字段类型必有说明
idstring是expose 唯一 id
namestring是expose 名称(如 ./Button)
pathstring否源码路径(若有)
filestring是产物文件
requiresstring[]是依赖列表
assetsStatsAssets是资源列表