babel-plugin-filter-imports

babel-plugin-filter-imports

This plugin is for Babel 6. If you need to support Babel 5 use the v0.2.x branch.

This babel plugin is used to removed references to imports within a module. This can be useful for removing debugging statements when doing a production build of your code. It is often used in conjunction with other tools like Uglify that perform dead code elimination.

Example

Given the .babelrc

{
  "plugins": [["filter-imports", {
    "imports": {
      "debugging-tools": [ "warn" ]
    }
  }]]
}

the module

import { warn } from 'debugging-tools';

function join(args, sep) {
  if (arguments.length > 2) {
    warn("join expects at most 2 arguments");
  }
  return args.join(sep);
}

will be transformed to

function join(args, sep) {
  if (arguments.length > 2) {
  }
  return args.join(sep);
}

Configuration

• options[keepImports] [Boolean]: An flag that indicates imports removal from header.
• options[imports] [Object]: An object whose keys are names of modules.
• options[imports][moduleName] [String]: An array of names of imports from moduleName to be removed. You can include 'default' for default export and '*' for a namespace export.

Upgrade to 1.x

There were breaking changes in the plugin configuration, you must update it to work correctly.

Before 1.x

{
  "plugins": [["filter-imports", {
    "debugging-tools": [ "warn" ]
  }]]
}

After

{
  "plugins": [["filter-imports", {
    "imports": {
      "debugging-tools": [ "warn" ]
    }
  }]]
}

Changelog

v1.1.0 (2017-10-08)

Full Changelog

Merged pull requests:

• chore(package): remove useless and update deps #29 (layershifter)
• fix(plugin): use babel-plugin-syntax-decorators #28 (layershifter)
• chore(CI): add lint step #27 (layershifter)
• feat(export): Adds support for filtering exports #26 (pzuraq)
• feat(plugin): add support for stripping decorators #25 (pzuraq)
• fix(plugin): fix the case of directly nested call expressions #24 (pzuraq)
• chore(package): update test commands #23 (layershifter)
• chore(package): update mocha to version 4.0.0 #22 (greenkeeper[bot])