babel-plugin-transform-es2015-modules-simple-commonjs
v0.3.0
Published
Simplified imports and exports
Downloads
781
Readme
babel-plugin-transform-es2015-modules-simple-commonjs
Simple transformer for ECMAScript 2015 modules (CommonJS).
Converts this code:
import x from '/path/to/x';
import y from '/path/to/y';
doSomething();
export default x + y;
Into this one:
var x = require('/path/to/x');
var y = require('/path/to/y');
doSomething();
module.exports = x + y;
Instead of this one (generated with babel-plugin-transform-es2015-modules-commonjs
):
Object.defineProperty(exports, "__esModule", {
value: true
});
var _x = require('/path/to/x');
var _x2 = _interopRequireDefault(_x);
var _y = require('/path/to/y');
var _y2 = _interopRequireDefault(_y);
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
doSomething();
exports.default = _x2.default + _y2.default;
This supports all standard es2015 import and export code with some caveats.
Caveats
When exporting the final value is used, not the value when writing an export statement. It is not supported to mutate declarations that have been exported. You will not be warned, it will just not work.
You cannot export default and export a named item in the same file as
module.exports
assignment will conflict with theexports
assignment. This transform will error if you attempt to do this.If you mix default imports and importing
*
, it will work, but will not be valid in ES2015. E.g. with the following...
// file a
export default 1;
// file b
import * as a from './a';
// file c
export const c = 3;
// file d
import c from './c';
In the official Babel module, a
in file b
will be undefined and c
in file d
will be undefined. Using this module, they will be 1
and 3
respectively.
- Updating the exports on-the-fly will not work. This is not supported within commonjs normally anyway, but is supported with the official plugin.
You may want to use a linter (such as eslint with eslint-plugin-import) in order to ensure that your code is standard whilst using this simplified transform.
Installation
$ npm install --save-dev babel-plugin-transform-es2015-modules-simple-commonjs
Usage
Via .babelrc
(Recommended)
.babelrc
{
"plugins": ["transform-es2015-modules-simple-commonjs"]
}
Via Node API
require('babel').transform('code', {
plugins: ['transform-es2015-modules-simple-commonjs']
});
Usage with other ES2015 plugins
This replaces the functionality in transform-es2015-modules-commonjs
, but you may be better off using this with the babel-preset-es2015-webpack
preset, which takes the es2015 preset and removes the commonjs transform.