babel-timing

Babel timing

Measure Babel compilation time file by file, plugin by plugin. See screenshot.

Get Babel transpilation insights when your application or your tests take ages to build.

Note: this tool is in version 0, any minor release might introduce breaking changes.

Installation

Can be installed both as global or local dependency.

npm i babel-timing
yarn add babel-timing

Usage

As standalone library via CLI

babel-timing path/to/file-1.js path/to/file-2.js
babel-timing path/to/file-*.js
babel-timing path/to/entrypoint.js --follow-imports

As standalone library via Node

const babelTiming = require('babel-timing').babelTiming;
const results = await babelTiming(['path/to/file.js'], options);

As Webpack integration

Hook babel-timing into your actual Webpack bundling process.

1. Import babel-timing/webpack/plugin to Webpack configuration:

const BabelTimingPlugin = require('babel-timing/webpack/plugin');

1. Add customize option to the existing babel-loader configuration:

use: {
  loader: 'babel-loader',
+  options: {
+    customize: require.resolve('babel-timing/webpack/babel-loader-customize')
+  },
}

1. Add babel-timing/webpack/plugin plugin (accepts output and outputPath options):

plugins: [
  // ...
+  new BabelTimingPlugin(),
]

1. Start your usual Webpack build

Options

babelConfig / --babel-config

Type: string | false
Default: undefined

Path to a custom babel configuration file. By default Babel will try to load any existing valid configuration file.

followImports / --follow-imports (experimental)

Type: bool
Default: false

Follow imported files/modules and run babel-timing against them.

include / --include

Type: string[] (cli accepts a string containing a comma-separated list)
Default: ['**']

Include paths (imported ones also) according to the provided glob patterns.

exclude / --exclude

Type: string[] (cli accepts a string containing a comma-separated list)
Default: ['**/modules/**']

Exclude paths (imported ones also) according to the provided glob patterns.

resolveMainFields / --resolve-main-fields

Type: string[] (cli accepts a string containing a comma-separated list)
Default: ['browser', 'module', 'main']

Determine which fields in imported modules's package.json are checked.

expandPackages / --expand-packages

Type: bool
Default: false

Expand results relative to node_modules packages file by file.

output / --output

Type: string
Default: "return" ("console" when called via CLI/Webpack)
Options: "return", "console", "json"

Make babel-timing results available as:

• "return" return results' object
• "console" render results in console
• "json" save results as babel-timing-results.json

outputPath / --output-path

Type: string
Default: "./babel-timing-results.json"

Path of output file in case output option is set to "json".

verbose / --verbose

Type: bool
Default: false

Log warnings.

How it works

Compile files with Babel 7 and get collect compilation info through wrapPluginVisitorMethod Babel config option.

Results

Compilation info are extracted into the following data structure:

type Results = {
  name: string,
  totalTime: number,
  plugins: {
    plugin: string,
    timePerVisit: number,
    time: number,
    visits: number,
  }[]
}[]

Notes

This tool started as an attempt of measuring the time taken by Babel while running transpiled tests and compiling Webpack applications.

The main difficulty of monitoring Babel while running the aforementioned tools, consists of relating the wrapPluginVisitorMethod calls to the files actually being compiled.

Any further idea/contribution to get to a better Babel monitoring solution is welcome.

Manual tests :)

node cli.js __fixtures__/file-1.js
node cli.js __fixtures__/file-1.js __fixtures__/file-2.js
node cli.js __fixtures__/*.js
node cli.js __fixtures__/entry.js --follow-imports

Thanks to

• babel-minify’s timing plugin
• Facebook fbt's timing plugin
• This Stack Overflow's question/answers

Todo

• Add csv output option
• Expose wrapPluginVisitorMethod
• Provide a way to consume babel-timing from other tools like jest, rollup, etc..
• Improve webpack integration
• Make followImports more reliable

Changelog

0.3.0

New Features

• Provide Webpack integration with babel-timing/webpack/plugin and babel-timing/webpack/babel-loader-customize
• Add outputPath option