服务端渲染

@module-federation/modern-js-v3 提供了非常强大的能力，开发者可以非常方便的在 Modern.js 应用中，组合使用 Module Federation 和服务端渲染（SSR）的能力。

开启 SSR

我们以使用模块联邦创建的应用为例，只需要在生产者和消费者上，都添加 server.ssr 配置即可：

modern.config.ts

import { appTools, defineConfig } from '@modern-js/app-tools';

export default defineConfig({
  server: {
    ssr: {
      mode: 'stream',
    },
  },
});

为更好的性能体验，我们仅支持 Streaming SSR 情况使用这种能力组合。

Warning

应用级别模块（使用 createBridgeComponent 和 createRemoteAppComponent 的模块）不支持服务端渲染（SSR）。如果你需要使用 SSR 功能，请使用组件级别的模块导出方式。

数据获取

Tip

目前该功能为实验性功能，功能还未经过充分实践，请谨慎使用。

Module Federation 在新版本中支持了数据获取的能力。每个生产者文件都可以有一个对应的数据获取文件，文件名格式为 [name].data.ts。

在 Modern.js 中，数据获取可以配合 SSR 使用。我们以前面章节的 Demo 为例子，创建一个数据获取文件：

src/components/Button.data.ts

import type { DataFetchParams } from '@module-federation/modern-js-v3/react';

export type Data = {
  data: string;
};

export const fetchData = async (params: DataFetchParams): Promise<Data> => {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve({
        data: `data: ${new Date()}`,
      });
    }, 1000);
  });
};

在 Button 中，我们从 Props 中获取到数据：

src/components/Button.tsx

import React from 'react';
import type { Data } from './Button.data';

export const Button = (props: { mfData: Data }) => {
  const { mfData } = props;
  return (
    <button type="button" className="test">
      Remote Button {mfData?.data}
    </button>
  );
};

消费组件

消费者必须使用 createLazyComponent 的方式加载远程组件，并指定 export 为 'default'。

src/routes/page.tsx

import type { JSX } from 'react';
import { getInstance } from '@module-federation/modern-js-v3/runtime';
import {
  ERROR_TYPE,
  lazyLoadComponentPlugin,
} from '@module-federation/modern-js-v3/react';

const instance = getInstance();
instance!.registerPlugins([lazyLoadComponentPlugin()]);

const Button = instance!.createLazyComponent({
  loader: () => {
    return import('remote/Button');
  },
  loading: 'loading...',
  export: 'Button', // 这里需要配置为远程组件的 export 名称
  fallback: ({ error, errorType, dataFetchMapKey }) => {
    console.error(error);
    if (errorType === ERROR_TYPE.LOAD_REMOTE) {
      return <div>load remote failed</div>;
    }
    if (errorType === ERROR_TYPE.DATA_FETCH) {
      return (
        <div>
          data fetch failed, the dataFetchMapKey key is: {dataFetchMapKey}
        </div>
      );
    }
    return <div>error type is unknown</div>;
  },
});

const Index = (): JSX.Element => {
  return (
    <div>
      <h1>Basic usage with data fetch</h1>
      <Button />
    </div>
  );
};

export default Index;

#服务端渲染

#开启 SSR

#数据获取

#消费组件

服务端渲染

开启 SSR

数据获取

消费组件