rtorr / broccoli-babel-transpiler

Broccoli plugin for Babel

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

broccoli-babel-transpiler

Build Status Build status

A Broccoli plugin which transpiles ES6 to readable ES5 by using babel.

How to install?

$ npm install broccoli-babel-transpiler --save-dev

How to use?

In your Brocfile.js:

var esTranspiler = require('broccoli-babel-transpiler');
var scriptTree = esTranspiler(inputTree, options);

You can find options at babel's github repo.

Examples

You'll find three example projects using this plugin in the repository broccoli-babel-examples. Each one of them builds on top of the previous example so you can progess from bare minimum to ambitious development.

About source map

Currently this plugin only supports inline source map. If you need separate source map feature, you're welcome to submit a pull request.

Advanced usage

filterExtensions is an option to limit (or expand) the set of file extensions that will be transformed.

The default filterExtension is js

var esTranspiler = require('broccoli-babel-transpiler');
var scriptTree = esTranspiler(inputTree, {
    filterExtensions:['js', 'es6'] // babelize both .js and .es6 files
});

exportModuleMetadata is an option that can be used to write a JSON file to the output tree that gives you metadata about the tree's imports and exports.

Polyfill

In order to use some of the ES6 features you must include the Babel polyfill.

You don't always need this, review which features need the polyfill here: ES6 Features.

var esTranspiler = require('broccoli-babel-transpiler');
var scriptTree = esTranspiler(inputTree, { browserPolyfill: true });

About

Broccoli plugin for Babel

License:MIT License


Languages

Language:JavaScript 100.0%