---
title: enableAsyncEntry
---

# source.enableAsyncEntry

- **类型：** `boolean`
- **默认值：** `false`

该选项用于 webpack 模块联邦（Module Federation）场景。

开启此选项后，Modern.js 会通过 dynamic import 来包裹自动生成的入口文件（Asynchronous Boundaries），使页面代码可以消费模块联邦生成的远程模块。

## 背景知识

import ModuleFederation from '@site-docs/components/module-federation.mdx';

<ModuleFederation />

## 示例

首先，在配置文件中开启此选项：

```ts title="modern.config.ts"
export default defineConfig({
  source: {
    enableAsyncEntry: true,
  },
});
```

然后执行 `dev` 或 `build` 命令，可以看到 Modern.js 自动生成的文件变为以下结构：

```bash
node_modules
  └─ .modern-js
     └─ main
        ├─ bootstrap.jsx  # 异步入口文件（asynchronous boundary）
        ├─ index.js      # 真正的入口代码
        └─ index.html
```

其中 `bootstrap.js` 的内容如下：

```js
import('./index.jsx');
```

此时，就可以在当前页面中消费任意的远程模块了。

:::info
Modern.js 未对 ModuleFederationPlugin 进行封装，请通过 [tools.bundlerChain](/configure/app/tools/bundler-chain) 自行配置 ModuleFederationPlugin。

:::
