# 转码结果输出到标准输出
$ babel example.js
# 转码结果写入一个文件
# --out-file 或 -o 参数指定输出文件
$ babel example.js --out-file compiled.js
# 或者
$ babel example.js -o compiled.js
# 整个目录转码
# --out-dir 或 -d 参数指定输出目录
$ babel src --out-dir lib
# 或者
$ babel src -d lib
# -s 参数生成source map文件
$ babel src -d lib -s
babel-node
babel-cli工具自带一个babel-node命令, 提供一个支持ES6的REPL环境。 它支持Node的REPL环境的所有功能, 而且可以直接运行ES6代码。
它不用单独安装, 而是随babel-cli一起安装。 然后, 执行babel-node就进入REPL环境。
$ babel-node
> (x => x * 2)(1)
2
babel-node
命令可以直接运行
ES6
脚本。 将上面的代码放入脚本文件
es6.js
, 然后直接运行。$ babel-node es6.js
2
babel-node
也可以安装在项目中。$ npm install --save-dev babel-cli
然后, 改写
package.json
。{
"scripts": {
"script-name": "babel-node script.js"
}
}
上面代码中, 使用
babel-node
替代
node
, 这样
script.js
本身就不用做任何转码处理。
babel-register
babel-register模块改写require命令, 为它加上一个钩子。 此后, 每当使用require加载.js、 .jsx、 .es和.es6后缀名的文件, 就会先用Babel进行转码。
$ npm install --save-dev babel-register
使用时, 必须首先加载babel-register。
require("babel-register");
require("./index.js");
然后, 就不需要手动对 index.js 转码了。
需要注意的是, babel-register 只会对 require 命令加载的文件转码, 而不会对当前文件转码。 另外, 由于它是实时转码, 所以只适合在开发环境使用。
babel-core
如果某些代码需要调用Babel的API进行转码, 就要使用babel-core模块。
安装命令如下。
$ npm install babel-core --save
然后, 在项目中就可以调用babel-core。
var babel = require('babel-core');
// 字符串转码
babel.transform('code();', options);
// => { code, map, ast }
// 文件转码(异步)
babel.transformFile('filename.js', options, function(err, result) {
result; // => { code, map, ast }
});
// 文件转码(同步)
babel.transformFileSync('filename.js', options);
// => { code, map, ast }
// Babel AST转码
babel.transformFromAst(ast, code, options);
// => { code, map, ast }
配置对象 options , 可以参看官方文档 http://babeljs.io/docs/usage/options/ 。
下面是一个例子。
var es6Code = 'let x = n => n + 1';
var es5Code = require('babel-core')
.transform(es6Code, {
presets: ['es2015']
})
.code;
// '"use strict";\n\nvar x = function x(n) {\n return n + 1;\n};'
上面代码中, transform 方法的第一个参数是一个字符串, 表示需要被转换的 ES6 代码, 第二个参数是转换的配置对象。
babel-polyfill
Babel默认只转换新的JavaScript句法(syntax) , 而不转换新的API, 比如Iterator、 Generator、 Set、 Maps、 Proxy、 Reflect、 Symbol、 Promise等全
局对象, 以及一些定义在全局对象上的方法(比如Object.assign) 都不会转码。
举例来说, ES6在Array对象上新增了Array.from方法。 Babel就不会转码这个方法。 如果想让这个方法运行, 必须使用babel-polyfill, 为当前环境
提供一个垫片。
安装命令如下。
$ npm install --save babel-polyfill
然后, 在脚本头部, 加入如下一行代码。
import 'babel-polyfill';
// 或者
require('babel-polyfill');
Babel 默认不转码的 API 非常多, 详细清单可以查看 babel-plugin-transform-runtime 模块的 definitions.js 文件。