Reduced size of application & improved performance plays an important role in success of a software. Tree Shaking is a concept in development of eliminating dead code or unused code.
Imagine your application as a tree. All the libraries, components, widgets & code represents leaves. All the unused code, imports & dead code represents the dead brown leaves. In order to clear dead leaves from trees you have to shake the tree to let them fall.
By implementing tree shaking practices website performance will get improved and reduce bundle size. Tree shaking depends on the static structure of ES6 module syntax (import & export).
The reason tree shaking is very important is because most packages installed don’t really need all dependencies & this results in importing full packages, however what really needed is a small part of that package.
Lets have an example:
Importing lodash package using CommonJS Module. This import will fetch entire package & all the un required dependencies.
const lodash = require('lodash'); 70.7K (gzipped: 24.7k)
Importing lodash package using ES6 (ES2015) Module. This import will only fetch specific dependency with tree shaking.
import {isArray} from 'lodash'; 1K (gzipped: 505)
As seen in example above the size of bundle is drastically reduced in ES6 import as compared to CommonJS module import.
Tree Shaking in React Application
If your project is built with create-react-app, the latest version has excellent tree shaking, if you are using an old version of react just update react-scripts to version 2.0.4 or higher.
npm install react-scripts@latest --save
In order to implement tree shaking in react application you will need to have a module bundler that will bundle the entire app’s code. You can either use WebPack or RollUp for bundling your application.
Webpack
webpack is an open-source JavaScript module bundler. It is made primarily for JavaScript. Webpack takes modules with dependencies and generates static assets representing those modules. Webpack uses the babel-preset-env
package, which bundles your files and transforms the files back to CommonJS module to support tree-shaking.
To achieve tree shaking, webpack requires some configuration. Create a file name webpack.config.js
and add below code:
module.exports = {
module: {
rules: [
{
test: /\.(js|jsx)$/,
exclude: /node_modules/,
use: {
loader: babel-loader,
options: {
presets: [
[ 'es2015', { modules: false }]
]
}
}
}
]
}
}
Configure the file in side-effect
A Side-effect is defined as code that performs a special behavior when imported, other than exposing one or more exports. Side effects occur when a function or expression modifies state outside its own context.
If all of application code does not contain side effects, we can simply mark the property as false to inform webpack that it can safely prune unused exports.
{
"name": "example-project",
"sideEffects": false
}
If your code have some side effects, an array can be provided in configuration instead:
{
"name": "example-project",
"sideEffects": [
"./src/file-with-side-effect.js",
"*.css"
]
}
Rollup
Rollup is a module bundler for JavaScript which compiles small pieces of code into something larger and more complex, such as a library or application. It uses the standardized ES module format for code, instead of previous idiosyncratic solutions such as CommonJS.
If you are using Rollup as your module bundler then by default it supports tree-shaking and does not require any additional configuration. Rollup statically analyzes the code you are importing, and will exclude anything that isn’t actually used. This allows you to build on top of existing tools and modules without adding extra dependencies or bloating the size of your project.
For example, while using CommonJS, the entire tool or library must be imported.
// import the entire utils object with CommonJS
const utils = require( './utils' );
const query = 'Rollup';
// use the ajax method of the utils object
utils.ajax(`https://demoapi.com?search=${query}`).then(handleResponse);
we can just import the one ajax function we need:
// import the ajax function with an ES6 import statement
import { ajax } from './utils';
const query = 'Rollup';
// call the ajax function
ajax(`https://demoapi.com?search=${query}`).then(handleResponse);
Conclusion
By implementing tree shaking practices website performance will get improved and reduce bundle size. Therefore we strongly recommend to implement tree-shaking practices while development.
Do you know any other tip/trick to implement tree shaking in React. Do let us know in comment section.