Babel browserify transform

$ npm install --save-dev babelify

$ browserify script.js -t babelify --outfile bundle.js

var fs = require("fs");
var browserify = require("browserify");
var babelify = require("babelify");
browserify("./script.js", { debug: true })
  .transform(babelify)
  .bundle()
  .on("error", function (err) { console.log("Error : " + err.message); })
  .pipe(fs.createWriteStream("bundle.js"));

Selected options are discussed below. See the babel docs for the complete list.

browserify().transform(babelify.configure({
  blacklist: ["regenerator"]
}))

$ browserify -d -e script.js -t [ babelify --blacklist regenerator ]

By default Babel's experimental transforms are disabled. You can turn them on individually by passing optional as a configuration option.

browserify().transform(babelify.configure({
  optional: ["es7.asyncFunctions"]
}))

$ browserify -d -e script.js -t [ babelify --optional es7.asyncFunctions ]

Alternatively, you can enable an entire TC39 category of experimental ES7 features via the stage configuration option.

browserify().transform(babelify.configure({
  stage: 0
}))

$ browserify -d -e script.js -t [ babelify --stage 0 ]

By default all files with the extensions .js, .es, .es6 and .jsx are compiled. You can change this by passing an array of extensions.

NOTE: This will override the default ones so if you want to use any of them you have to add them back.

browserify().transform(babelify.configure({
  extensions: [".babel"]
}))

$ browserify -d -e script.js -t [ babelify --extensions .babel ]

NOTE: Keep in mind that to get browserify to find files with extensions it doesn't include by default, you may also need to configure them there. For example, to have require('./script') in a browserified file resolve to a ./script.babel file, you'd need to configure browserify to also look for the .babel extension. See the extensions option documentation.

Browserify passes an absolute path so there's no way to determine what folder it's relative to. You can pass a relative path that'll be removed from the absolute path with the sourceMapRelative option.

browserify().transform(babelify.configure({
  sourceMapRelative: "/Users/sebastian/Projects/my-cool-website/assets"
}))

$ browserify -d -e script.js -t [ babelify --sourceMapRelative . ]

browserify().transform(babelify.configure({
  // Optional ignore regex - if any filenames **do** match this regex then they
  // aren't compiled
  ignore: /regex/,

  // Optional only regex - if any filenames **don't** match this regex then they
  // aren't compiled
  only: /my_es6_folder/
}))

$ browserify -d -e script.js -t [ babelify --ignore regex --only my_es6_folder ]

As a convenience, the babelify polyfill is exposed in babelify. If you've got a browserify-only package this may alleviate the necessity to have both babel & babelify installed.

// In browser code
require("babelify/polyfill");

This is default browserify behaviour and can not be overriden. A possible solution is to add:

{
  "browserify": {
    "transform": ["babelify"]
  }
}

to the root of all your modules package.json that you want to be transformed. If you'd like to specify options then you can use:

{
  "browserify": {
    "transform": [["babelify", { "optional": ["es7.asyncFunctions"] }]]
  }
}