#Experiments

experiments 配置用于启用插件中的实验功能。

#asyncStartup

• Type: boolean
• Required: No
• Default: false

启用 asyncStartup 后，所有 Module Federation 入口将默认以异步方式初始化。这意味着：

• 无需在应用顶部手动添加 import() 语句（例如 import('./bootstrap')）
• 所有入口都会自动处理异步初始化
• 通过自动的异步处理机制防止 "eager consumption" 错误

#externalRuntime

• Type: boolean
• Required: No
• Default: false

设置 true 后 会 external Module Federation runtime，并使用消费者提供的 runtime 。（请确保你的消费者有设置 provideExternalRuntime: true，否则无法正常运行！）

#provideExternalRuntime

• Type: boolean
• Required: No
• Default: false

设置 true 后会在消费者处注入 Module Federation runtime。

#optimization

该对象包含与构建期优化相关的标记，这些标记会影响 Module Federation 运行时的体积与行为。

#disableSnapshot

• Type: boolean
• Required: No
• Default: false

当设置为 true 时，该选项会在构建期间将全局常量 FEDERATION_OPTIMIZE_NO_SNAPSHOT_PLUGIN 定义为 true。在 @module-federation/runtime-core 中，这会阻止 snapshotPlugin() 与 generatePreloadAssetsPlugin() 被打包并在 Module Federation 实例中初始化。

影响：

• 收益： 排除这两个插件的代码后，可减小 Module Federation 运行时的整体包体积。
• 代价： 会禁用这两个插件提供的能力。snapshotPlugin 对 “mf-manifest 协议” 非常关键，它负责生成或在运行时提供构建清单（例如 mf-manifest.json）的访问能力，清单中包含暴露模块、共享依赖、版本与远程模块等元数据。禁用后意味着：
  • 运行时将无法访问这份构建清单数据。
  • 依赖清单的能力（如动态远程发现、基于清单的版本兼容检查、高级资源预加载（也由被移除的 generatePreloadAssetsPlugin 处理）以及可能的运行时调试/自省工具）将无法正常工作或不可用。
  • 仅当你不依赖这些由清单驱动的能力，并且更优先考虑最小化运行时体积时，才建议开启此选项。

#target

• Type: 'web' | 'node'
• Required: No
• Default: Inferred from Webpack's target option (usually 'web')

该选项会在构建期间定义全局常量 ENV_TARGET，用于指定目标运行环境。

影响：

• target: 'web'：针对浏览器环境优化构建。
  • 确保使用浏览器端的远程入口加载机制（loadEntryDom）。
  • 关键点在于会对 @module-federation/sdk 中 Node.js 专属代码启用 tree-shaking/死代码消除。createScriptNode、loadScriptNode 等函数及其依赖的 Node.js 内置模块（如 vm、path、http）会被完全移出产物，从而显著减小包体积。
• target: 'node'：针对 Node.js 环境优化构建。
  • 确保使用 Node.js 端的远程入口加载机制（loadEntryNode）。
  • 会把 SDK 中 Node.js 场景所需的函数（createScriptNode、loadScriptNode）保留在产物中，保证联邦应用在 Node.js 中正常运行。

建议显式设置该值，以确保应用预期优化，尤其是在同构或服务端渲染场景中。

#优化标记对 remoteEntry.js 体积的影响

下表展示了 disableSnapshot、target: 'web' 与 externalRuntime 这几个优化标记在不同组合下，对生成的 remoteEntry.js 文件体积的影响。这些数据可帮助你在运行时功能与包体积之间做出取舍。

说明：

• 同时开启 disableSnapshot 与 target: 'web' 可获得更明显的体积下降，配合 externalRuntime: true 时效果最佳。
• 使用外部运行时（externalRuntime: true）可大幅缩小 remote entry 体积，但前提是消费者侧提供运行时。
• 更小的包体积通常意味着更快的加载速度与更好的性能，但也可能禁用部分能力（各标记行为见上文）。