@module-federation/utilities v3.1.21
utils
For warning: @module-federation/runtime
is recommended as a replacement
This library was generated with Nx.
Building
Run nx build utils
to build the library.
Running unit tests
Run nx test utils
to execute the unit tests via Jest.
React utilities
FederatedBoundary
A component wrapper that provides a fallback for safe imports if something were to fail when grabbing a module off of a remote host.
This wrapper also exposes an optional property for a custom react error boundary component.
Any extra props will be passed directly to the imported module.
Usage looks something like this:
import { FederationBoundary } from '@module-federation/utilities/src/utils/react';
// defining dynamicImport and fallback outside the Component to keep the component identity
// another alternative would be to use useMemo
const dynamicImport = () => import('some_remote_host_name').then((m) => m.Component);
const fallback = () => import('@npm/backup').then((m) => m.Component);
const MyPage = () => {
return <FederationBoundary dynamicImporter={dynamicImport} fallback={fallback} customBoundary={CustomErrorBoundary} />;
};
ImportRemote
A function which will enable dynamic imports of remotely exposed modules using the Module Federation plugin. It uses the method described in the official Webpack configuration under Dynamic Remote Containers.
This function will allow you to provide a static url or an async method to retrieve a url from a configuration service.
Usage looks something like this:
import { importRemote } from '@module-federation/utilities';
// --
// If it's a regular js module:
// --
importRemote({
url: 'http://localhost:3001',
scope: 'Foo',
module: 'Bar',
}).then(
(
{
/* list of Bar exports */
},
) => {
// Use Bar exports
},
);
// --
// If it's a ESM module (this is currently the default for NX):
// --
const Bar = lazy(() => importRemote({ url: 'http://localhost:3001', scope: 'Foo', module: 'Bar', esm: true }));
return (
<Suspense fallback={<div>Loading Bar...</div>}>
<Bar />
</Suspense>
);
// --
// If Bar is a React component you can use it with lazy and Suspense just like a dynamic import:
// --
const Bar = lazy(() => importRemote({ url: 'http://localhost:3001', scope: 'Foo', module: 'Bar' }));
return (
<Suspense fallback={<div>Loading Bar...</div>}>
<Bar />
</Suspense>
);
import { importRemote } from '@module-federation/utilities';
// If it's a regular js module:
importRemote({
url: () => MyAsyncMethod('remote_name'),
scope: 'Foo',
module: 'Bar',
}).then(
(
{
/* list of Bar exports */
},
) => {
// Use Bar exports
},
);
// If Bar is a React component you can use it with lazy and Suspense just like a dynamic import:
const Bar = lazy(() =>
importRemote({
url: () => MyAsyncMethod('remote_name'),
scope: 'Foo',
module: 'Bar',
}),
);
return (
<Suspense fallback={<div>Loading Bar...</div>}>
<Bar />
</Suspense>
);
// You can also combine importRemote and FederationBoundary to have a dynamic remote URL and a fallback when there is an error on the remote
const dynamicImporter = () =>
importRemote({
url: 'http://localhost:3001',
scope: 'Foo',
module: 'Bar',
});
const fallback = () => import('@npm/backup').then((m) => m.Component);
const Bar = () => {
return <FederationBoundary dynamicImporter={dynamicImporter} fallback={fallback} />;
};
Apart from url, scope and module you can also pass additional options to the importRemote() function:
- remoteEntryFileName: The name of the remote entry file. Defaults to "remoteEntry.js".
- bustRemoteEntryCache: Whether to add a cache busting query parameter to the remote entry file URL. Defaults to true. You can disable it if cachebusting is handled by the server.
8 months ago
8 months ago
7 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
9 months ago
8 months ago
8 months ago
8 months ago
9 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
9 months ago
9 months ago
8 months ago
9 months ago
8 months ago
9 months ago
8 months ago
9 months ago
9 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
11 months ago
11 months ago
10 months ago
1 year ago
10 months ago
1 year ago
12 months ago
1 year ago
11 months ago
1 year ago
10 months ago
11 months ago
12 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
11 months ago
12 months ago
12 months ago
11 months ago
1 year ago
12 months ago
11 months ago
11 months ago
11 months ago
12 months ago
11 months ago
10 months ago
10 months ago
11 months ago
1 year ago
11 months ago
11 months ago
1 year ago
11 months ago
12 months ago
10 months ago
11 months ago
11 months ago
12 months ago
10 months ago
12 months ago
11 months ago
1 year ago
1 year ago
11 months ago
10 months ago
10 months ago
10 months ago
11 months ago
12 months ago
10 months ago
11 months ago
1 year ago
1 year ago
10 months ago
11 months ago
1 year ago
11 months ago
10 months ago
10 months ago
11 months ago
11 months ago
1 year ago
11 months ago
10 months ago
1 year ago
1 year ago
1 year ago
11 months ago
10 months ago
10 months ago
1 year ago
11 months ago
1 year ago
10 months ago
12 months ago
1 year ago
12 months ago
10 months ago
1 year ago
10 months ago
1 year ago
12 months ago
10 months ago
12 months ago
1 year ago
10 months ago
10 months ago
1 year ago
11 months ago
10 months ago
10 months ago
10 months ago
1 year ago
1 year ago
12 months ago
12 months ago
10 months ago
11 months ago
12 months ago
10 months ago
1 year ago
11 months ago
11 months ago
12 months ago
10 months ago
1 year ago
11 months ago
1 year ago
1 year ago
12 months ago
10 months ago
11 months ago
10 months ago
1 year ago
12 months ago
12 months ago
11 months ago
1 year ago
10 months ago
1 year ago
1 year ago
11 months ago
12 months ago
12 months ago
12 months ago
10 months ago
10 months ago
1 year ago
11 months ago
12 months ago
11 months ago
1 year ago
11 months ago
12 months ago
10 months ago
1 year ago
10 months ago
12 months ago
10 months ago
1 year ago
1 year ago
10 months ago
12 months ago
12 months ago
1 year ago
11 months ago
11 months ago
12 months ago
1 year ago
12 months ago
12 months ago
10 months ago
10 months ago
10 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
12 months ago
12 months ago
12 months ago
12 months ago
10 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
12 months ago
10 months ago
11 months ago
11 months ago
12 months ago
11 months ago
1 year ago
12 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
3 years ago
3 years ago
2 years ago
2 years ago
2 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago