From b4c2573df08612b5e9fc82e1f5dba64a1242ca05 Mon Sep 17 00:00:00 2001
From: nyqykk <1327719263@qq.com>
Date: Thu, 19 Sep 2024 11:55:32 +0800
Subject: [PATCH] docs: modify prefetch doc
---
apps/website-new/docs/en/guide/_meta.json | 5 -
.../docs/en/guide/performance/prefetch.mdx | 288 -
apps/website-new/docs/en/practice/_meta.json | 5 +
.../performance/_meta.json | 0
.../docs/en/practice/performance/prefetch.mdx | 287 +
.../data-prefetch/advanced-prefetch.jpg | Bin 0 -> 58970 bytes
.../performance/data-prefetch/common.jpg | Bin 135618 -> 47241 bytes
.../performance/data-prefetch/prefetch.jpg | Bin 133791 -> 52064 bytes
apps/website-new/docs/zh/guide/_meta.json | 5 -
apps/website-new/docs/zh/practice/_meta.json | 5 +
.../performance/_meta.json | 0
.../performance/prefetch.mdx | 31 +-
pnpm-lock.yaml | 43260 +++++++++-------
13 files changed, 23736 insertions(+), 20150 deletions(-)
delete mode 100644 apps/website-new/docs/en/guide/performance/prefetch.mdx
rename apps/website-new/docs/en/{guide => practice}/performance/_meta.json (100%)
create mode 100644 apps/website-new/docs/en/practice/performance/prefetch.mdx
create mode 100644 apps/website-new/docs/public/guide/performance/data-prefetch/advanced-prefetch.jpg
rename apps/website-new/docs/zh/{guide => practice}/performance/_meta.json (100%)
rename apps/website-new/docs/zh/{guide => practice}/performance/prefetch.mdx (89%)
diff --git a/apps/website-new/docs/en/guide/_meta.json b/apps/website-new/docs/en/guide/_meta.json
index 17fba4f39ff..4188a69d562 100644
--- a/apps/website-new/docs/en/guide/_meta.json
+++ b/apps/website-new/docs/en/guide/_meta.json
@@ -13,10 +13,5 @@
"type": "dir",
"name": "framework",
"label": "Frameworks"
- },
- {
- "type": "dir",
- "name": "performance",
- "label": "Performance"
}
]
diff --git a/apps/website-new/docs/en/guide/performance/prefetch.mdx b/apps/website-new/docs/en/guide/performance/prefetch.mdx
deleted file mode 100644
index 33ad9b21e76..00000000000
--- a/apps/website-new/docs/en/guide/performance/prefetch.mdx
+++ /dev/null
@@ -1,288 +0,0 @@
-# Data Prefetch
-
-:::warning
-This function is not currently supported in Rspack provider projects.
-:::
-
-## What is Data Prefetch
-Data Prefetch can prefetch remote module API requests in parallel with the loading of js and css, improving the speed of the first screen.
-
-- The normal loading process for consumers:
-
-Host HTML (consumer HTML) -> Host main.js (consumer entry js) -> Host fetch (consumer authentication and other pre-actions) -> Provider main.js (producer entry js) -> Provider fetch (producer sends requests)
-
-- The loading process after using Prefetch
-
-
-As you can see, the producer's request is moved forward to be parallel with some js, **currently in the simplest scenario with no pre-operations, the first screen can see an improvement of tens to hundreds of milliseconds, theoretically second screens can fully achieve render on load**, and in scenarios with long pre-processes, the overall rendering speed of the module can be greatly improved.
-
-## How to use
-1. Install the `@module-federation/enhanced` package for both `producer` and `consumer`.
-
-import { Tab, Tabs } from '@theme';
-
-
-
-```bash
-npm install @module-federation/enhanced
-```
-
-
-```bash
-yarn add @module-federation/enhanced
-```
-
-
-```bash
-pnpm add @module-federation/enhanced
-```
-
-
-
-2. In the producer project, create a `.prefetch.ts` or `.prefetch.js` file in the same directory as the expose module. For example, given the following exposes:
-```ts title=rsbuild(webpack).config.ts
-new ModuleFederationPlugin({
- exposes: {
- '.': './src/index.tsx',
- './Button': './src/Button.tsx',
- },
- // ...
-})
-```
-In this case, the producer project has two `exposes`: `.` and `./Button`.
-So you can create two prefetch files `index.prefetch.ts` and `Button.prefetch.ts` under `src`. Here's an example for `Button`:
-
-**Note: exported functions must be either default exported or end with Prefetch (case insensitive) to be recognized as Prefetch functions**
-```ts title=Button.prefetch.ts
-// Here we use the defer API provided by react-router-dom as an example.
-// Whether to use this API depends on your needs.
-// Refer to the FAQ: "Why use defer, Suspense, Await components".
-// You can install this package with npm install react-router-dom
-import { defer } from 'react-router-dom';
-
-const defaultVal = {
- data: {
- id: 1,
- title: 'A Prefetch Title',
- }
-};
-
-// Note: exported functions must be either default exported or end with Prefetch (case insensitive) to be recognized as Prefetch functions
-export default (params = defaultVal) => defer({
- userInfo: new Promise(resolve => {
- setTimeout(() => {
- resolve(params);
- }, 2000);
- })
-})
-```
-
-In `Button`
-```tsx title=Button.tsx
-import { Suspense } from 'react';
-import { usePrefetch } from '@module-federation/enhanced/prefetch';
-import { Await } from 'react-router-dom';
-
-interface UserInfo {
- id: number;
- title: string;
-};
-const reFetchParams = {
- data: {
- id: 2,
- title: 'Another Prefetch Title',
- }
-}
-export default function Button() {
- const [prefetchResult, reFetchUserInfo] = usePrefetch({
- // Corresponding to (name + expose) in ModuleFederationPlugin, e.g., `@mf/app2/Button` for consuming `Button.prefetch.ts`
- id: '@mf/app2/Button',
- // Optional, required if using defer
- deferId: 'userInfo',
- // Default export usually doesn't need functionId. This is for illustration.
- // If not a default export, the function name should be provided.
- // functionId: 'default',
- });
-
- return (
- <>
-
- Loading...}>
- (
-
-
{userInfo.data.id}
-
{userInfo.data.title}
-
- )}
- />
-
-
- )
-};
-```
-
-3. Set `dataPrefetch`: true in the producer's ModuleFederationPlugin configuration
-```ts
- new ModuleFederationPlugin({
- // ...
- dataPrefetch: true
- }),
-```
-
-With this setup, interface prefetching is completed. After the consumer uses `Button`, the interface request will be sent out early (when loading js resources, instead of waiting for the component to render).
-In the example above, `Button` will first render `loading...`, then after 2 seconds, display the data.
-Clicking `Resend request with parameters` will resend the request with parameters, updating the component.
-
-## Viewing Optimization Effects
-Open log mode in the browser console to view outputs (it is best to simulate user scenarios under browser caching mode, otherwise the data may be inaccurate).
-The default optimization effect is data3 minus data1 (simulating user requests in `useEffect`). If your request is not sent in `useEffect`, you can manually call `performance.now()` where the interface is executed to subtract data1.
-```ts
-localStorage.setItem('FEDERATION_DEBUG', 1)
-```
-
-
-## API
-### usePrefetch
-#### Function
-- Used to retrieve prefetch data results and control refetching.
-
-#### Type
-```ts
-type Options = {
- id: string; // Required. Corresponds to (name + expose) in the producer MF configuration, e.g., `@mf/app2/Button` for consuming `Button.prefetch.ts`
- functionId?: string; // Optional (default is 'default'). Used to get the export function name in .prefetch.ts files. The function must end with Prefetch (case insensitive)
- deferId?: string; // Optional (required if using defer). If using defer, the function returns an object with multiple keys corresponding to multiple requests. deferId is a key in this object used to get the specific request.
- cacheStrategy?: () => boolean; // Optional. Generally, this is managed by the framework and controls whether to update the request result cache. It currently refreshes the cache after the component is unmounted or after manually executing the reFetch function.
-} => [
- Promise,
- reFetch: (refetchParams?: refetchParams) => void, // Used to re-send requests, typically for scenarios where the component's internal state changes and the interface needs to re-request data. Calling this function will resend and update the request result cache.
-];
-
-type refetchParams: any; // Used to send parameters with the request when the component refetches.
-```
-
-#### Usage
-```ts
-import { Suspense } from 'react';
-import { usePrefetch } from '@module-federation/enhanced/prefetch';
-import { Await } from 'react-router-dom';
-
-export const Button = () => {
- const [userInfoPrefetch, reFetchUserInfo] = usePrefetch({
- // Corresponding to (name + expose) in the producer MF configuration, e.g., `@mf/app2/Button` for consuming `Button.prefetch.ts`
- id: '@mf/app2/Button',
- // Optional, required if using defer
- deferId: 'userInfo'
- // Default export usually doesn't need functionId. This is for illustration.
- // If not a default export, the function name should be provided.
- // functionId: 'default',
- });
-
- return (
- <>
-
- Loading...}>
- (
-
-
{userInfo.data.id}
-
{userInfo.data.title}
-
- )}
- />
-
- <>
- )
-}
-```
-
-### loadRemote
-#### Function
-If users manually call the [loadRemote](/guide/basic/runtime.html#loadremote) API in the consumer project, it will be considered that the consumer wishes to load both the producer's static resources and prefetch the interface request. This can give the project faster rendering speeds, especially for scenarios where the first screen has pre-requests or where it is desired for second screens to be rendered immediately.
-#### Usage
-```ts
-import { loadRemote } from '@module-federation/enhanced/runtime';
-
-loadRemote('@mf/app2/Button');
-```
-
-#### Note
-This may cause data caching issues. The producer will prioritize using the prefetched interface results (the user may have already modified the server-side data through interaction). In such cases, outdated data might be used for rendering. Please use this feature according to your project's needs.
-
-## Frequently Asked Questions
-
-### 1. Is there a difference with React Router v6's [Data Loader](https://reactrouter.com/en/main/route/loader)?
-React Router's Data Loader can only be used in monolithic projects, it cannot be reused across projects. Additionally, Data Loader is bound to routes, not modules (exposes). Data Prefetch is more suitable for remote loading scenarios.
-
-### 2. Why use defer, Suspense, and Await components? [Reference link](https://reactrouter.com/en/main/guides/deferred)
-The defer and Await components are APIs and components provided by React Router v6 for handling data loading and rendering during the loading phase. They are typically used in conjunction with React's Suspense to achieve: rendering loading -> rendering content process. As you can see, defer returns an object. When the Prefetch function is executed, all the keys in the object corresponding to the requests (i.e., values) are sent out at once. defer will track the states of these Promises, working with Suspense and Await to complete the rendering, and these requests will not block the component's rendering (the component will display loading... until the component finishes rendering).
-
-### 3. Can I not use defer, Suspense, and Await?
-Yes, but if the exported function contains blocking operations (such as an await or a Promise), the component will wait for the function to complete before rendering. Even if the component's content is already loaded, the component may still wait for the interface to complete before rendering. For example:
-```ts
-export default (params) => (
- new Promise(resolve => {
- setTimeout(() => {
- resolve(params);
- }, 2000);
- })
-)
-```
-
-### 4. Why not defer everything by default?
-To make the developer's scenario more controllable. In some scenarios, developers may prefer the user to see a complete page all at once, rather than rendering loading. This allows developers to better balance the scenario. [Reference](https://reactrouter.com/en/main/guides/deferred#why-not-defer-everything-by-default)
-
-### 5. Can Prefetch carry parameters?
-The initial request, due to the parallel nature of request time and js resource loading, does not support passing parameters from within the component. You can manually set default values. The usePrefetch function returns a reFetch function, which can be used to resend the request with parameters and update data within the component.
-
-### 6. How to minimally modify the business for Prefetch?
-1. Place the interface that needs to be prefetched into the `.prefetch.ts` file.
-2. Wrap the prefetch function with `defer` and return an object (you can also directly return an object. If you return a value, it will block with the component js loading).
-3. In the business component, requests generally sent in `useEffect`:
-```ts title=Button.tsx
-import { useState, useEffect } from 'react';
-import { usePrefetch } from '@module-federation/enhanced/prefetch';
-
-export const Button = () => {
- const [state, setState] = useState(defaultVal);
- const [userInfoPrefetch, reFetchUserInfo] = usePrefetch({
- // Corresponding to (name + expose) in producer MF configuration, e.g., `@mf/app2/Button` for consuming `Button.prefetch.ts`
- id: '@mf/app2/Button',
- // Optional parameter, required if using defer
- deferId: 'userInfo',
- // Default export usually doesn't need functionId. This is for illustration.
- // If not default export, the function name should be provided.
- // functionId: 'default',
- });
-
- useEffect(() => {
- // Requests are commonly sent here in normal scenarios
- userInfoPrefetch
- .then(data => (
- // Update data
- setState(data)
- ));
- }, []);
-
- return (
- <>{state.defaultVal}
- )
-}
-```
-
-### 7. Why does the Prefetch function I defined not work?
-Note that exported functions must be either default exported or end with Prefetch (case insensitive) to be recognized as Prefetch functions.
-
-### 8. Can modules optimize performance for second screens?
-Yes, the performance improvement is quite significant. Since Data Prefetch is for all expose modules, the second screen modules can also optimize performance.
-```ts
-import { loadRemote } from '@module-federation/enhanced/runtime';
-
-loadRemote('@mf/app2/Button');
-```
-
-### 9. What if I want to use it with Vue or other frameworks?
-We provide a universal Web API but have not yet provided hooks like `usePrefetch` for Vue or other frameworks. We will support this in the future.
diff --git a/apps/website-new/docs/en/practice/_meta.json b/apps/website-new/docs/en/practice/_meta.json
index a1801b35d23..e47d7cfb1a3 100644
--- a/apps/website-new/docs/en/practice/_meta.json
+++ b/apps/website-new/docs/en/practice/_meta.json
@@ -20,5 +20,10 @@
"name": "scenario",
"label": "Scenarios",
"collapsed": true
+ },
+ {
+ "type": "dir",
+ "name": "performance",
+ "label": "Performance"
}
]
diff --git a/apps/website-new/docs/en/guide/performance/_meta.json b/apps/website-new/docs/en/practice/performance/_meta.json
similarity index 100%
rename from apps/website-new/docs/en/guide/performance/_meta.json
rename to apps/website-new/docs/en/practice/performance/_meta.json
diff --git a/apps/website-new/docs/en/practice/performance/prefetch.mdx b/apps/website-new/docs/en/practice/performance/prefetch.mdx
new file mode 100644
index 00000000000..3a23ab43d32
--- /dev/null
+++ b/apps/website-new/docs/en/practice/performance/prefetch.mdx
@@ -0,0 +1,287 @@
+# Data Prefetch
+
+:::warning
+This feature is not currently supported by Rspack producer projects
+:::
+
+## What is Data Prefetch
+Data Prefetch can advance the remote module interface request to be sent immediately after `remoteEntry` is loaded, without waiting for component rendering, thus improving the first screen speed.
+
+## Applicable scenarios
+The pre-process of the first screen of the project is long (for example, authentication and other operations are required) or the scenario where the data is expected to be directly output on the second screen
+
+- Conventional loading process of hosts:
+
+`Host HTML`(hosts HTML) -> `Host main.js`(hosts entry js) -> `Host fetch`(hosts authentication and other pre-actions) -> `Provider main.js`(producer entry js) -> `Provider fetch`(producer sends request)
+
+- Loading process after using Prefetch
+
+- Call `loadRemote` in advance in the pre-process (loadRemote will send the producer interface request with prefetch requirements synchronously)
+
+
+You can see that the producer's request is advanced to the root part js in parallel. **Currently, the optimization effect of the first screen depends on the project loading process. Theoretically, the second screen can be directly output by calling `loadRemote` in advance**, which can greatly improve the overall rendering speed of the module when the front process is long
+
+## Usage
+1. Install the `@module-federation/enhanced` package for `producer` and `hosts`
+
+import { Tab, Tabs } from '@theme';
+
+
+
+```bash
+npm install @module-federation/enhanced
+```
+
+
+```bash
+yarn add @module-federation/enhanced
+```
+
+
+```bash
+pnpm add @module-federation/enhanced
+```
+
+
+
+2. Add a `.prefetch.ts(js)` file to the producer's expose module directory. If there is the following `exposes`
+``` ts title=rsbuild(webpack).config.ts
+new ModuleFederationPlugin({
+ exposes: {
+ '.': './src/index.tsx',
+ './Button': './src/Button.tsx',
+ },
+ // ...
+})
+```
+At this time, the producer project has two `exposes`, `.` and `./Button`,
+then we can create two prefetch files, `index.prefetch.ts` and `Button.prefetch.ts`, under `src`, taking `Button` as an example
+
+**Note that the exported function must be exported as default or Prefetch It will be recognized as a Prefetch function only when it ends with default export or Prefetch (case insensitive)**
+``` ts title=Button.prefetch.ts
+// Here, the defer API provided by react-router-dom is used as an example. Whether to use this API can be determined according to needs. Refer to the question "Why use defer, Suspense, and Await components"
+// Users can install this package through npm install react-router-dom
+import { defer } from 'react-router-dom';
+
+const defaultVal = {
+ data: {
+ id: 1,
+ title: 'A Prefetch Title',
+ }
+};
+
+// Note that the exported function must end with default export or Prefetch to be recognized as a Prefetch function (case insensitive)
+export default (params = defaultVal) => defer({
+ userInfo: new Promise(resolve => {
+ setTimeout(() => {
+ resolve(params);
+ }, 2000);
+ })
+})
+```
+
+Use in `Button`
+```tsx title=Button.tsx
+import { Suspense } from 'react';
+import { usePrefetch } from '@module-federation/enhanced/prefetch';
+import { Await } from 'react-router-dom';
+
+interface UserInfo {
+ id: number;
+ title: string;
+};
+const reFetchParams = {
+ data: {
+ id: 2,
+ title: 'Another Prefetch Title',
+ }
+}
+export default function Button () {
+ const [prefetchResult, reFetchUserInfo] = usePrefetch({
+ // Corresponds to (name + expose) in producer ModuleFederationPlugin, for example, `app2/Button` is used for consumption `Button.prefetch.ts`
+ id: 'app2/Button',
+ // Optional parameter, required after using defer
+ deferId: 'userInfo',
+ // default export does not need to pass functionId by default, here is an example, if it is not default export, you need to fill in the function name,
+ // functionId: 'default',
+ });
+
+ return (
+ <>
+
+ Loading...}>
+ (
+
+
{userInfo.data.id}
+
{userInfo.data.title}
+
+ )}
+ >
+
+
+ )
+};
+```
+
+3. Set `dataPrefetch: true` in the producer's ModuleFederationPlugin configuration
+```ts
+new ModuleFederationPlugin({
+ // ...
+ dataPrefetch: true
+}),
+```
+This completes the interface pre-request. After `Button` is used by the hosts, the interface request will be sent out in advance (it will be sent when the js resource is loaded, and the normal project needs to wait until the component is rendered).
+In the above example, `Button` will first render `loading...`, and then display the data after 2s
+Click `Resend request with parameters` to re-trigger the request and add parameters to update the component
+
+## View the optimization effect
+Open the log mode in the browser console to view the output (it is best to use the browser cache mode to simulate the user scenario, otherwise the data may be inaccurate)
+The default optimization effect is data 3 minus data 1 (simulating the user sending a request in `useEffect`). If your request is not sent in `useEffect`, you can manually call `performance.now()` at the interface execution. to subtract data 1
+``` ts
+localStorage.setItem('FEDERATION_DEBUG', 1)
+```
+
+
+## API
+### usePrefetch
+#### Function
+- Used to obtain pre-request data results and control re-initiated requests
+
+#### Type
+``` ts
+type Options: {
+ id: string; // Required, corresponding to (name + expose) in the producer MF configuration, for example, `app2/Button` is used to consume `Button.prefetch.ts`.
+ functionId?: string; // Optional (default is default), used to get the name of the function exported in the .prefetch.ts file, the function needs to end with Prefetch (case insensitive)
+ deferId?: string; // Optional (required after using defer), after using defer, the function return value is an object (there can be multiple keys in the object corresponding to multiple requests), deferId is a key in the object, used to get the specific request
+ cacheStrategy?: () => boolean; // Optional, generally not manually managed, managed by the framework, used to control whether to update the request result cache, currently after the component is uninstalled or the reFetch function is manually executed, the cache will be refreshed
+} => [
+ Promise,
+ reFetch: (refetchParams?: refetchParams) => void, // Used to re-initiate a request, often used in scenarios where the interface needs to re-request data after the internal state of the component is updated. Calling this function will re-initiate a request and update the request result cache
+];
+
+type refetchParams: any; // Used to re-initiate requests with parameters in components
+```
+
+#### Usage
+``` ts
+import { Suspense } from 'react';
+import { usePrefetch } from '@module-federation/enhanced/prefetch';
+import { Await } from 'react-router-dom';
+
+export const Button = () => {
+ const [userInfoPrefetch, reFetchUserInfo] = usePrefetch({
+ // Corresponds to (name + expose) in the producer MF configuration, for example, `app2/Button` is used to consume `Button.prefetch.ts`
+ id: 'app2/Button',
+ // Optional parameter, required after using defer
+ deferId: 'userInfo'
+ // default export does not need to pass functionId by default, here is an example, if it is not default export, you need to fill in the function name,
+ // functionId: 'default',
+ });
+
+return (
+ <>
+
+ Loading...}>
+ (
+
+
{userInfo.data.id}
+
{userInfo.data.title}
+
+ )}
+ >
+
+ <>
+ )
+}
+```
+
+### loadRemote
+#### Function
+If the user manually calls [loadRemote](/zh/guide/basic/runtime.html#loadremote) in the hosts project API, then it will be considered that the hosts not only wants to load the producer's static resources, but also wants to send the interface request in advance, which can make the project render faster. This is especially effective in the scenario where **the first screen has a pre-request** or **you want the second screen to be directly displayed**. It is suitable for the scenario where the second screen module is loaded in advance on the current page.
+#### How to use
+``` ts
+import { loadRemote } from '@module-federation/enhanced/runtime';
+
+loadRemote('app2/Button');
+```
+
+#### Note
+Note that this may cause data caching problems, that is, the producer will give priority to the pre-requested interface results (the user may have modified the server data through interactive operations). In this case, outdated data will be used for rendering. Please use it reasonably according to the project situation.
+
+## Questions and Answers
+
+### 1. Is there any difference with [Data Loader](https://reactrouter.com/en/main/route/loader) of React Router v6?
+React Router's Data Loader can only be used for single projects, that is, it cannot be reused across projects. At the same time, Data Loader is bound by route, not by module (expose). Data Prefetch is more suitable for remote loading scenarios.
+
+### 2. Why use defer, Suspense, and Await components? [Reference link](https://reactrouter.com/en/main/guides/deferred)
+Defer and Await components are APIs and components provided by React Router v6 for data loading and rendering loading. The two are usually used with React's Suspense to complete the process of rendering loading -> rendering content. You can see that defer returns an object. When the Prefetch function is executed, all requests corresponding to the keys in this object (that is, value) will be sent out at once, and defer will track the status of these Promises, cooperate with Suspense and Await to complete the rendering, and these requests will not block the rendering of the component (loading... will be displayed before the component rendering is completed)
+
+### 3. Can I not use defer, Suspense and Await?
+
+Yes, but if there is a blocking function execution operation in the export function (for example, there is await or the return is a Promise), the component will wait for the function to complete before rendering. Even if the component content has been loaded, the component may still wait for the interface to complete before rendering, for example
+``` ts
+export default (params) => (
+ new Promise(resolve => {
+ setTimeout(() => {
+ resolve(params);
+ }, 2000);
+ })
+)
+```
+### 4. Why not defer everything by default?
+Make the developer scenario more controllable. In some scenarios, developers prefer users to see the entire page at once, rather than rendering loading. This allows developers to better weigh the scenarios. [Reference](https://reactrouter.com/en/main/guides/deferred#why-not-defer-everything-by-default)
+
+### 5. Can Prefetch carry parameters?
+For the first request, since the request time and js resource loading are parallel, it does not support passing parameters from within the component. You can manually set the default value. And usePrefetch will return the reFetch function, which is used to resend the request to update data within the component. At this time, it can carry parameters
+
+### 6. How to operate the business to minimize cost transformation?
+1. Put the interface that needs to be prefetched in .prefetch.ts
+2. The prefetch function is wrapped with `defer` to return an object (you can also return an object directly. If you return a value, it will be blocked by the component js loading await)
+3. Business components generally send requests in `useEffect`:
+``` ts Button.tsx
+import { useState } from 'react';
+import { usePrefetch } from '@module-federation/enhanced/prefetch';
+
+export const Button = () => {
+ const [state, setState] = useState(defaultVal);
+ const [userInfoPrefetch, reFetchUserInfo] = usePrefetch({
+ // Corresponds to (name + expose) in the producer MF configuration, for example, `app2/Button` is used to consume `Button.prefetch.ts`
+ id: 'app2/Button',
+ // Optional parameter, required after using defer
+ deferId: 'userInfo',
+ // default export does not need to pass functionId by default, here is an example, if it is not default export, you need to fill in the function name,
+ // functionId: 'default',
+ });
+
+useEffect(() => {
+ // General scenario usually sends a request here
+ userInfoPrefetch
+ .then(data => (
+ // Update data
+ setState(data)
+ ));
+ }, []);
+
+ return (
+ <>{state.defaultVal}<>
+ )
+}
+```
+
+### 7. Why does the Prefetch function I defined not work?
+Note that the exported function must end with default export or Prefetch to be recognized as a Prefetch function (case insensitive)
+
+### 8. Can the module optimize performance in the secondary screen?
+Yes, and the effect is quite obvious. Since Data Prefetch is for all expose modules, the secondary screen module can also optimize performance
+``` ts
+import { loadRemote } from '@module-federation/enhanced/runtime';
+
+loadRemote('app2/Button');
+```
+
+### 9. What to do if you want to use Vue or other frameworks?
+We provide a general Web API, but we do not provide a hook like `usePrefetch` in other frameworks such as Vue. We will support it later.
diff --git a/apps/website-new/docs/public/guide/performance/data-prefetch/advanced-prefetch.jpg b/apps/website-new/docs/public/guide/performance/data-prefetch/advanced-prefetch.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..15be2aae5a444c8a65225d7cc83c93e196f0537b
GIT binary patch
literal 58970
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