Tree Shaking

Detox - Testing React Native - Interview with Mykola Solopii

Tree shaking is a feature enabled by the ES2015 module definition. The idea is that given it's possible to analyze the module definition statically without running it, webpack can tell which parts of the code are being used and which are not. It's possible to verify this behavior by expanding the application and adding code there that should be eliminated.

Tree shaking works to an extent through webpack-common-shake against CommonJS module definition. As a majority of npm packages have been authored using the older definition, the plugin has value.

Demonstrating Tree Shaking#

To shake code, you have to define a module and use only a part of its code. Set one up:


const shake = () => console.log("shake");
const bake = () => console.log("bake");

export { shake, bake };

To make sure you use a part of the code, alter the application entry point:


import { bake } from "./shake";



If you build the project again (npm run build) and examine the build (dist/main.js), it should contain console.log("bake"), but miss console.log("shake"). That's tree shaking in action.

To get a better idea of what webpack is using for tree shaking, run it through npm run build -- --display-used-exports. You should see additional output like [no exports used] or [only some exports used: bake] in the terminal.

If you are using terser-webpack-plugin, enable warnings for a similar effect. In addition to other messages, you should see lines like Dropping unused variable treeShakingDemo [./src/component.js:17,6].
There is a CSS Modules related tree shaking proof of concept at dead-css-loader.

Tree Shaking on Package Level#

The same idea works with dependencies that use the ES2015 module definition. Given the related packaging, standards are still emerging, you have to be careful when consuming such packages. Webpack tries to resolve package.json module field for this reason.

For tools like webpack to allow tree shake npm packages, you should generate a build that has transpiled everything else except the ES2015 module definitions and then point to it through package.json module field. In Babel terms, you have to let webpack to manage ES2015 modules by setting "modules": false.

To get most out of tree shaking with external packages, you have to use babel-plugin-transform-imports to rewrite imports so that they work with webpack's tree shaking logic. See webpack issue #2867 for more information.

SurviveJS - Maintenance covers how to write your packages so that it's possible to apply tree shaking against them.


Tree shaking is a potentially powerful technique. For the source to benefit from tree shaking, npm packages have to be implemented using the ES2015 module syntax, and they have to expose the ES2015 version through package.json module field tools like webpack can pick up.

To recap:

  • Tree shaking drops unused pieces of code based on static code analysis. Webpack performs this process for you as it traverses the dependency graph.
  • To benefit from tree shaking, you have to use ES2015 module definition.
  • As a package author, you can provide a version of your package that contains ES2015 modules, while the rest has been transpiled to ES5.

You'll learn how to manage environment variables using webpack in the next chapter.

Previous chapter

This book is available through Leanpub (digital), Amazon (paperback), and Kindle (digital). By purchasing the book you support the development of further content. A part of profit (~30%) goes to Tobias Koppers, the author of webpack.

Need help?