Code Splitting

Instead of downloading the entire app before users can use it, code splitting allows you to split your code into small chunks which you can then load on demand.

This project setup supports code splitting via dynamic import(). Its proposal is in stage 4. The import() function-like form takes the module name as an argument and returns a Promise which always resolves to the namespace object of the module.

Here is an example:

moduleA.js

  1. const moduleA = 'Hello';
  3. export { moduleA };

App.js

  1. import React, { Component } from 'react';
  3. class App extends Component {
  4.   handleClick = () => {
  5.     import('./moduleA')
  6.       .then(({ moduleA }) => {
  7.         // Use moduleA
  8.       })
  9.       .catch(err => {
  10.         // Handle failure
  11.       });
  12.   };
  14.   render() {
  15.     return (
  16.       <div>
  17.         <button onClick={this.handleClick}>Load</button>
  18.       </div>
  19.     );
  20.   }
  21. }
  23. export default App;

This will make moduleA.js and all its unique dependencies as a separate chunk that only loads after the user clicks the 'Load' button. For more information on the chunks that are created, see the production build section.

You can also use it with async / await syntax if you prefer it.

With React Router

If you are using React Router check out this tutorial on how to use code splitting with it. You can find the companion GitHub repository here.

Also check out the Code Splitting section in React documentation.