README.md

babel-preset-babili

Babel preset for all minify plugins.

• Install
• Usage
• Options

Install

$ npm install --save-dev babel-preset-babili

Usage

Via .babelrc (Recommended)

.babelrc

{
  "presets": ["babili"]
}

or pass in options -

{
  "presets": [["babili", {
    "mangle": {
      "blacklist": ["MyCustomError"]
    },
    "unsafe": {
      "typeConstructors": false
    },
    "keepFnName": true
  }]]
}

Via CLI

$ babel script.js --presets babili

Via Node API

require("babel-core").transform("code", {
  presets: ["babili"]
});

Options

All options are enabled by default except the ones with explicit mention - (Default: false)

Three types of options:

1-1 mapping with plugin

• false to disable the plugin
• true to enable the plugin with default plugin specific options
• { ...pluginOpts } to enable the plugin with custom plugin options

The following options have 1-1 mapping with a plugin,

• evaluate - babel-plugin-minify-constant-folding
• deadcode - babel-plugin-minify-dead-code-elimination
• infinity - babel-plugin-minify-infinity
• mangle - babel-plugin-minify-mangle-names
• numericLiterals - babel-plugin-minify-numeric-literals
• replace - babel-plugin-minify-replace
• simplify - babel-plugin-minify-simplify
• mergeVars - babel-plugin-transform-merge-sibling-variables
• booleans - babel-plugin-transform-minify-booleans
• regexpConstructors - babel-plugin-transform-regexp-constructors
• removeConsole - (Default: false) - babel-plugin-transform-remove-console
• removeDebugger - (Default: false) - babel-plugin-transform-remove-debugger
• removeUndefined - babel-plugin-transform-remove-undefined
• undefinedToVoid - babel-plugin-transform-undefined-to-void

Examples

{
  "presets": [["babili", {
    "evaluate": false,
    "mangle": true
  }]]
}

{
  "presets": [["babili", {
    "mangle": {
      "blacklist": [
        "ParserError",
        "NetworkError"
      ]
    }
  }]]
}

Option groups

• false to disable the entire group
• true to enable every plugin in the group
• { pluginKey: <1-1 mapping> } - enable/disable a particular plugin in a group (or) pass options to that plugin

The following are groups of plugins -

• unsafe
  • flipComparisons - babel-plugin-minify-flip-comparisons
  • simplifyComparisons - babel-plugin-transform-simplify-comparison-operators
  • guards - babel-plugin-minify-guarded-expressions
  • typeConstructors - babel-plugin-minify-type-constructors
• properties
  • memberExpressions - babel-plugin-transform-member-expression-literals
  • propertyLiterals - babel-plugin-transform-property-literals

Examples

Disables all unsafe plugins:

{
  "presets": [["babili", {
    "unsafe": false
  }]]
}

Disables only minify-guarded-expressions, and enable all other unsafe plugins:

{
  "presets": [["babili", {
    "unsafe": {
      "guards": false
    }
  }]]
}

Passing same plugin options to multiple plugins

In babili, multiple plugins require the same set of options and it is easier to mention it in one place instead of two.

• keepFnName - This will be passed to mangle and deadcode and will NOT be overriden if the same option exists under either mangle or deadcode.

Examples

{
  "presets": [["babili", {
    "keepFnName": true
  }]]
}

is the same as,

Plugins applied:

{
  "presets": [["babili", {
    "mangle": {
      "keepFnName": true
    },
    "deadcode": {
      "keepFnName": true
    }
  }]]
}