https://github.com/garthenweb/bubleify
Browserify transform that compiles es2015 to es5 using Bublé
https://github.com/garthenweb/bubleify
browserify buble es6
Last synced: about 1 month ago
JSON representation
Browserify transform that compiles es2015 to es5 using Bublé
- Host: GitHub
- URL: https://github.com/garthenweb/bubleify
- Owner: garthenweb
- License: mit
- Created: 2016-04-19T22:03:51.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2022-12-07T17:33:29.000Z (over 2 years ago)
- Last Synced: 2024-10-03T08:47:36.281Z (8 months ago)
- Topics: browserify, buble, es6
- Language: JavaScript
- Homepage:
- Size: 721 KB
- Stars: 20
- Watchers: 4
- Forks: 7
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bubléify [![build status][1]][2] [![Coverage Status][3]][4]
A browserify transform for [Bublé](https://www.npmjs.com/package/buble) to transform ES2015 to ES5.
## Installation
``` bash
npm install --save-dev bubleify
```
## Usage
### Node
``` javascript
const browserify = require('browserify');
const bubleify = require('bubleify');
const b = browserify();
b.add('./file.es2015.js'));
b.transform(bubleify, {
target: {
chrome: 48,
firefox: 44,
},
transforms: {
arrow: true,
defaultParameter: false,
dangerousForOf: true,
},
});
b.bundle();
```
### CLI
``` bash
browserify script.js -o bundle.js -t [ bubleify ]
```
## Options
### target: Object
Target specifies a list of environments the output file should be compatible to. Bublè will decide based on this list which transforms should be used.
### transforms: Object
Transforms define which ES2015 features should or should not be transformed into ES5.
Bublèify by default disables the `module` transform to not throw an error when ES2015 `import` and `export` statements are used. If you want to use ES2015 modules you should add another transform to do so.
Find a list of all transforms on the Bublè documentation in section [list of transforms](http://buble.surge.sh/guide/#list-of-transforms). For more detailed information about each transform also see [supported features](http://buble.surge.sh/guide/#supported-features) and [dangerous transforms](http://buble.surge.sh/guide/#dangerous-transforms).
### sourceMap: Boolean
Define whether an inline source map should or should not be created by Bublé.
Default is `true`.
_Please note that browserify will not output any source map if debug mode is `false`, even if sourceMap was set to `true`._
### extensions: Array
The allowed file extensions that should be transformed with Bublé. Files included into the stream that do not match an extension will be ignored by Bubléify.
Default is `['.js', '.jsx', '.es', '.es6']`.
### bubleError: Boolean
Define whether the error generated by Bublè or a the Bublè error message as a string should be emitted in case of an error.
Default is `false`.
_Bublè may in some situations throw a custom error. Browserify will, when used on the command line, just output the call stack in this situation but does not show the error message. Turning this option on will display the error message but suppresses the call stack._
## Credits
Thanks goes to [Rich Harris](https://twitter.com/rich_harris) for the [Bublè](https://www.npmjs.com/package/buble) package.
## License
Licensed under the [MIT License](https://opensource.org/licenses/mit-license.php).
[1]: https://travis-ci.org/garthenweb/bubleify.svg
[2]: https://travis-ci.org/garthenweb/bubleify
[3]: https://coveralls.io/repos/github/garthenweb/bubleify/badge.svg?branch=master
[4]: https://coveralls.io/github/garthenweb/bubleify?branch=master