Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aaronfrost/grunt-traceur
This is a grunt task for adding a grunt task to compiler ES6 JS into ES3 JS using Traceur Compiler
https://github.com/aaronfrost/grunt-traceur
Last synced: 3 months ago
JSON representation
This is a grunt task for adding a grunt task to compiler ES6 JS into ES3 JS using Traceur Compiler
- Host: GitHub
- URL: https://github.com/aaronfrost/grunt-traceur
- Owner: aaronfrost
- License: mit
- Created: 2013-02-19T23:04:58.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2022-12-06T18:15:15.000Z (almost 2 years ago)
- Last Synced: 2024-07-10T00:06:12.730Z (4 months ago)
- Language: JavaScript
- Homepage:
- Size: 280 KB
- Stars: 206
- Watchers: 10
- Forks: 34
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE-MIT
Awesome Lists containing this project
- es6-tools - grunt-traceur - traceur-build](https://github.com/tarruda/grunt-traceur-build) (Build-time transpilation / Grunt Tasks)
README
_published the 0.5.0 release to npmjs.org_
# grunt-traceur
[](https://travis-ci.org/aaronfrost/grunt-traceur)
> A grunt plugin for Google's Traceur-Compile, a lib to compile ES6 JavaScript into ES5 JavaScript.
## Getting Started
This plugin requires Grunt `~0.4.0`
If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
```shell
npm install grunt-traceur --save-dev
```
One the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
```js
grunt.loadNpmTasks('grunt-traceur');
```
## The "traceur" task
### Overview
In your project's Gruntfile, add a section named `traceur` to the data object passed into `grunt.initConfig()`.
```js
grunt.initConfig({
traceur: {
options: {
// traceur options here
experimental: true,
// module naming options,
moduleNaming: {
stripPrefix: "src/es6",
addPrefix: "com/mycompany/project"
},
copyRuntime: 'src/es5'
},
custom: {
files: [{
expand: true,
cwd: 'src/es6',
src: ['*.js'],
dest: 'src/es5'
}]
},
},
})
```
Once the files have been transpiled into ES5, you can minify or concat them.
### Options
Any specified option will be passed through directly to traceur, thus you can specify any option that traceur supports.
Some common options:
* `experimental` - Turn on all experimental features
* `blockBinding` - Turn on support for `let` and `const`
* `copyRuntime` - Copies the traceur_runtime.js to the location which you specify here
* `moduleNames` - Generate named module (default: true)
* `moduleNaming.stripPrefix` - Strip the specified prefix from generated module names
* `moduleNaming.addPrefix` - Add the specified prefix to the generated module names (applied AFTER the `moduleNaming.stripPrefix` option)
## Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using [Grunt](http://gruntjs.com/).
## Release History
_(Nothing yet)_