@loadable/component

Enable Code Splitting in your React application.

Install

npm install @loadable/component

Documentation

👉 See full documentation

License

MIT

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

5.16.7 (2025-05-18)

Note: Version bump only for package loadable-components

5.16.6 (2025-05-18)

Note: Version bump only for package loadable-components

5.16.5 (2024-04-20)

Note: Version bump only for package loadable-components

5.16.4 (2024-04-20)

Bug Fixes

• correct esm configuration for loadable/server, fixes: #999 (#1004) (114cea2)

5.16.3 (2023-12-26)

Bug Fixes

• correct react-is for mjs export; remove isValidComponent check (#991) (9d381c3)

5.16.2 (2023-12-15)

Bug Fixes

• add esm exports to package.json and change esm bundle extension to .mjs to allow node.js to properly import esm version of package. (#989) (e4a3718)

5.16.1 (2023-07-20)

Bug Fixes

• correct babel plugin default signature to allow any source of 'loadable' (#972) (19849b6), closes #971

5.16.0 (2023-07-09)

Features

• Allow additional identifiers to be passed in to the babel plugin (#966) (e18e37a)

5.15.3 (2023-01-28)

Bug Fixes

• add React 17 and 18 to package dependencies, fixes #718 (66edc37)

5.15.2 (2021-12-12)

Bug Fixes

• Clear correct cache when compiling with Webpack (#838) (3b9cb20)
• loadAsync Loadable should copy statics (#839) (9ff6693)
• use stable promises for load/preload/React (#858) (45f2d91)

5.15.1 (2021-08-17)

Bug Fixes

• add cachedAssets to stats options (#779) (73b17fd), closes #770
• SubResourceIntegrity (#803) (9b34195)

5.15.0 (2021-05-08)

Bug Fixes

• add displayNames to generated components (#731) (b640c82)

Features

• support multiple Webpack runtimes (#701) (d351367)
• webpack plugin doesn't need all chunk info (#735) (cea9f24)

5.14.2 (2021-01-31)

Bug Fixes

• ignore css chunk (#689) (6926e19)
• remove main asset path query (#686) (dde2252)
• update hooks for webpack 5 (#676) (671ef52)

5.14.1 (2020-10-22)

Note: Version bump only for package loadable-components

5.14.0 (2020-10-20)

Bug Fixes

• add key to chunks script elements (#631) (25b532e), closes #628
• do not derive cache key if component is static, fixes #629 (#630) (b4151d8)
• treat mjs as script (575fe2b)

Features

• make packages webpack 5 compatible (#638) (e882e4d)

5.13.2 (2020-09-14)

Bug Fixes

• Fixed lazy usage with Suspense and Error Boundary together (#521) (42fbdd0)
• human readable errors (b86bb82)
• spread nested required chunks array (95e6ecb)
• typo (bebb828)

5.13.1 (2020-07-02)

Bug Fixes

• expose used chunkNames from a server. Fixes #587 (831aec0)

5.13.0 (2020-06-29)

Bug Fixes

• allow webpack cache is ready only for initial chunks, fixes #558 (61f8b75)
• memory leak in module cache management, fixes #560 (6c11703)
• use make-dir instead of mkdirp (#544) (5a9c33b)
• babel-plugin: add missing peer dependency (#524) (03a79b6)

Features

• add resolveComponent option (a47d3d9)

5.12.0 (2020-01-09)

Bug Fixes

• apply loadable transformations before any other, fixes #466 (ac5ba45)

Features

• add codemods to migrate from react-loadable (#463) (a82d5ad)
• avoid synchronous loading on client if options.ssr is false (#346) (338bf55)
• loadable-components.com (e515b0e)

Performance Improvements

• avoid calling stats.toJson if possible (87698de)

5.11.0 (2019-12-02)

Bug Fixes

• fix isReady problem (#445) (3024348), closes #400
• server: use require instead of module.require (#457) (064b4f8), closes #455

Features

• add support for SRI (integrity) (with webpack-subresource-integrity) (#436) (586ad0a)

5.10.3 (2019-09-24)

Bug Fixes

• empty cache on each server reload (#431) (d4428c6), closes #230
• support IE 11 without polyfill (#416) (80ee809), closes #397
• babel-plugin: fix bug when using + concatenation instead of a template literal (#425) (d98dd27)

5.10.2 (2019-07-15)

Bug Fixes

• use === instead of Object.is (c88cd82), closes #371

Performance Improvements

• use more performant url join impl (#353) (c3fbbef)

5.10.1 (2019-05-14)

Bug Fixes

• add @babel/preset-env in rollup config (#336) (8b50c94), closes #335

5.10.0 (2019-05-13)

Bug Fixes

• fix chunkname mismatch (#332) (7ffaa4c), closes #331

Features

• add load method that returns a Promise (#329) (a10a9d5), closes #226
• support reactive dynamic loadable (#330) (d65c5bb), closes #284

Performance Improvements

• optimize rollup config (c94760b)

5.9.0 (2019-04-23)

Features

• support multiple react apps (#317) (dc54050), closes #311
• server: authorize custom filesystem (#318) (f2a6bbd), closes #315

5.8.0 (2019-04-10)

Bug Fixes

• babel-plugin: Use require.resolve instead of relative path resolution (#303) (bad7f1f)

Features

• ChunkExtractor: support publicPath override (#292) (9731e9c)
• server: support function in attributes (#277) (c172324)

Performance Improvements

• server: improve lodash imports for serverless bundles (#298) (96841f2)

5.7.2 (2019-03-20)

Bug Fixes

• babel-plugin: handle "-" at the end of request (c0f325b)

5.7.1 (2019-03-19)

Bug Fixes

• babel-plugin: handle special chars in file names (#279) (4da39ff)
• webpack-plugin: create output folder with mkdirp (#273) (3767f28)

5.7.0 (2019-03-14)

Bug Fixes

• component: fix warning message about babel (#255) (7cb68a1), closes #253
• server: fix loading order of assets (#266) (4c8ae60)

Features

• use inline JSON to enabling CSP without unsafe-inline (05e5500)

Performance Improvements

• build: add build target for Node (#267) (97ff6ac)

5.6.1 (2019-02-25)

Bug Fixes

• component: better ES Modules handling (#228) (3628363)
• server: allow query-param cache busting in chunk names (#229) (71f7bcd)
• server: use eval to prevent webpack warning (#240) (948165d), closes #234
• suspense: fix suspense mode in React v16.8+ (#251) (d04e1c9)

5.6.0 (2019-02-05)

Bug Fixes

• Add extra props option for links (#212) (6714d2a)
• server: fix chunkName resolving (#219) (ef11e11)

Features

• babel-plugin: transform code annotated with magic comment (4f832dc), closes #192
• component: add preload method (#224) (4a67ace), closes #196
• server: add option to disable SSR (#223) (4cab4f9), closes #195

5.5.0 (2019-01-22)

Features

• allow to specify extra attributes in getScriptTags & others (#210) (8a3d067)

5.4.0 (2019-01-17)

Features

• webpack-plugin: support custom path in writeToDisk option (#187) (4a6f84f)

5.3.0 (2019-01-11)

Features

• support inline CSS (#190) (2caf676)

5.2.2 (2018-12-12)

Bug Fixes

• babel-plugin: fix chunkName with aggressive code splitting (e974933), closes #182
• ensure that component is mounted before calling setState (#184) (fe0f47f), closes #180
• server: fix usage when compiled using webpack (#185) (5e28870), closes #181

5.2.1 (2018-11-27)

Bug Fixes

• webpack-plugin: fix TypeError when set writeToDisk true (#170) (2d1fb11)
• upgrade hoist-non-react-statics@3.2.0 (122b1ce)

5.2.0 (2018-11-23)

Bug Fixes

• server: fix url join (#166) (ba90289)
• server: support protocol free paths (#163) (3b5b115)

Features

• webpack-plugin: add writeToDisk option (#161) (6b5ba21)

5.1.3 (2018-11-20)

Bug Fixes

• server: exclude http and https from regex (#155) (0bb2ad9), closes #153
• server: ignore *.hot-update.js (edcd2c8), closes #148

5.1.2 (2018-11-13)

Bug Fixes

• fix ref handler in loadable.lib (da05d87)

5.1.1 (2018-11-13)

Bug Fixes

• server: ignore source maps (9991bbd), closes #128

5.1.0 (2018-11-10)

Features

• server: add outputPath option in ChunkExtractor (aac26b3)

5.0.2 (2018-11-10)

Bug Fixes

• update peer dependencies (b0363dc)

5.0.0 (2018-11-10)

Bug Fixes

• fix loadableReady (59693bb)

Features

• improve SSR support (eb1cfe8)

BREAKING CHANGES

• • SSR has been rewritten from scratch, if you use it, please follow the new guide.
• Prefetch component and prefetch functions have been removed, please use webpackPrefetch instead.

4.0.5 (2018-11-01)

Bug Fixes

• server: fix getScriptElements (ba424e0)

4.0.4 (2018-10-31)

Bug Fixes

• fix peer dependencies (6816e8c)

4.0.3 (2018-10-31)

Bug Fixes

• server: disable common chunks optim (78e7b28)

4.0.2 (2018-10-31)

Bug Fixes

• babel-plugin: transform into friendly chunk name (54422cb)
• component: fix lazy usage (d711ee0)

4.0.1 (2018-10-30)

Bug Fixes

• component: do not call ref several times (8cf3190)

4.0.0 (2018-10-30)

Features

• add new loadable.lib, change API (94b2e87)

BREAKING CHANGES

• • ErrorComponent is ignored, please use Error Boundaries to handle errors.
• lazy is no longer exported
• LoadingComponent is replaced by fallback option
• ref are now forwarded

3.0.2 (2018-10-30)

Bug Fixes

• component: fix loadComponent (typo) (a410cb2)

3.0.1 (2018-10-30)

Bug Fixes

• component: fix loadComponents (bd2220c)

3.0.0 (2018-10-29)

Bug Fixes

• typescript: restore types (#113) (240bb8f)

Features

• welcome loadable (4dffad7)

BREAKING CHANGES

• API has completely changed, see documentation.

Change Log

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

2.2.3 (2018-08-16)

Bug Fixes

• fix type definitions (#95) (8402c19), closes #95
• support non-ES modules (#104) (2a82314)

2.2.2 (2018-05-25)

Bug Fixes

• fix error handling in loadComponents (#87) (d32c74c), closes #87

2.2.1 (2018-05-23)

2.2.0 (2018-05-23)

Bug Fixes

• fix SSR with HMR #85 (20138e1), closes #85

Features

• experimental suspense 🤩 (57ce712)

2.1.0 (2018-05-13)

Features

• add TypeScript definitions (#80) (db19796)

2.0.1 (2018-05-12)

Bug Fixes

• fix module resolving (10318b0), closes #59

2.0.0 (2018-05-10)

Bug Fixes

• do not propagate componentId (fff1248)

Code Refactoring

• remove HMR relative code (ef0817c)

BREAKING CHANGES

• setConfig is no longer available.

1.4.0 (2018-04-18)

Bug Fixes

• set correct loading state if component is already loaded. (#64) (9b0cae2)

Features

• support React.createContext API (#65) (289ad67)

1.3.0 (2018-04-06)

Bug Fixes

• circular structure in error object (#60) (96333ca)
• React 16.3 compatibility (abd7963), closes #57

Features

• attach static properties on load (d383fab), closes #58

1.2.0 (2018-03-25)

Features

• add Hot Reload support (c79085e)

1.1.1 (2018-02-06)

Bug Fixes

• snapshot: fix snap usage (3445bea), closes #40

1.1.0 (2018-02-04)

Features

• ship a single js file (99e08c0)

1.0.2 (2018-02-04)

Bug Fixes

• state could have no children (a47c410), closes #36

1.0.1 (2018-02-03)

Bug Fixes

• fix loadComponents without valid state (35f81a6), closes #34

1.0.0 (2018-02-02)

Features

• stable version 1 (601bd34)

BREAKING CHANGES

• loadable-components/babel is now required if you do server side rendering.
• ErrorComponent now receive ownProps instead of props.