参考文档 Babel 插件手册 html
Babel
的做用Babel
是一个JavaScript
编译器node
不少浏览器目前还不支持ES6的代码,Babel
的做用就是把浏览器不资辞的代码编译成资辞的代码。react
注意很重要的一点就是,Babel
只是转译新标准引入的语法,好比ES6的箭头函数转译成ES5的函数, 可是对于新标准引入的新的原生对象,部分原生对象新增的原型方法,新增的API等(如Set
、Promise
),这些Babel
是不会转译的,须要引入polyfill
来解决。git
Babel
其实是一组模块的集合。github
Babel
的编译器,核心 API 都在这里面,好比常见的transform
、parse
。shell
npm i @babel/core -D
复制代码
import { transform } from '@babel/core';
import * as babel from '@babel/core';
复制代码
babel.transform(code: string, options?: Object)express
babel.transform(code, options, function(err, result) {
result; // => { code, map, ast }
});
复制代码
babel.parse(code: string, options?: Object, callback: Function)npm
cli
是命令行工具, 安装了@babel/cli
就可以在命令行中使用babel
命令来编译文件。编程
npm i @babel/core @babel/cli -D
复制代码
babel script.js
复制代码
Note: 由于没有全局安装
@babel/cli
, 建议用npx
命令来运行,或者./node_modules/.bin/babel
,关于npx
命令,能够看下官方文档json
直接在node
环境中,运行 ES6 的代码
npx babel-node script.js
复制代码
Babel
的解析器
首先,安装一下这个插件。
npm i babylon -S
复制代码
先从解析一个代码字符串开始:
// src/index.js
import * as babylon from 'babylon';
const code = `function add(m, n) { return m + n; }`;
babylon.parse(code);
复制代码
npx babel-node src/index.js
复制代码
Node {
type: "File",
start: 0,
end: 38,
loc: SourceLocation {...},
program: Node {...},
comments: [],
tokens: [...]
}
复制代码
用于对 AST 的遍历,维护了整棵树的状态,而且负责替换、移除和添加节点。
运行如下命令安装:
npm i babel-traverse -S
复制代码
import * as babylon from 'babylon';
import traverse from 'babel-traverse';
const code = `function add(m, n) { return m + n; }`;
const ast = babylon.parse(code);
traverse(ast, {
enter(path) {
if (
path.node.type === 'Identifier' &&
path.node.name === 'm'
) {
// do something
}
}
});
复制代码
用于 AST 节点的 Lodash 式工具库, 它包含了构造、验证以及变换 AST 节点的方法,对编写处理 AST 逻辑很是有用。
npm i babel-types -S
复制代码
import traverse from 'babel-traverse';
import * as t from 'babel-types';
traverse(ast, {
enter(path) {
if (t.isIdentifier(path.node, { name: 'm' })) {
// do something
}
}
});
复制代码
Babel 的代码生成器,它读取AST并将其转换为代码和源码映射(sourcemaps)
npm i babel-generator -S
复制代码
import * as babylon from 'babylon';
import generate from 'babel-generator';
const code = `function add(m, n) { return m + n; }`;
const ast = babylon.parse(code);
generate(ast, {}, code);
// {
// code: "...",
// map: "...",
// rawMappings: "..."
// }
复制代码
Babel
是怎么工做的为了理解Babel
,咱们从ES6最受欢迎的特性箭头函数入手。
假设要把下面这个箭头函数的Javascript
代码
(foo, bar) => foo + bar;
复制代码
编译成浏览器支持的代码:
'use strict';
(function (foo, bar) {
return foo + bar;
});
复制代码
Babel的编译过程和大多数其余语言的编译器类似,能够分为三个阶段:
Babel
拿到源代码会把代码抽象出来,变成AST
(抽象语法树),洋文是Abstract Syntax Tree
。
抽象语法树是源代码的抽象语法结构的树状表示,树上的每一个节点都表示源代码中的一种结构,这因此说是抽象的,是由于抽象语法树并不会表示出真实语法出现的每个细节,好比说,嵌套括号被隐含在树的结构中,并无以节点的形式呈现。它们主要用于源代码的简单转换。
箭头函数(foo, bar) => foo + bar;
的AST长这样:
{
"type": "Program",
"start": 0,
"end": 202,
"body": [
{
"type": "ExpressionStatement",
"start": 179,
"end": 202,
"expression": {
"type": "ArrowFunctionExpression",
"start": 179,
"end": 202,
"id": null,
"expression": true,
"generator": false,
"params": [
{
"type": "Identifier",
"start": 180,
"end": 183,
"name": "foo"
},
{
"type": "Identifier",
"start": 185,
"end": 188,
"name": "bar"
}
],
"body": {
"type": "BinaryExpression",
"start": 193,
"end": 202,
"left": {
"type": "Identifier",
"start": 193,
"end": 196,
"name": "foo"
},
"operator": "+",
"right": {
"type": "Identifier",
"start": 199,
"end": 202,
"name": "bar"
}
}
}
}
],
"sourceType": "module"
}
复制代码
上面的AST
描述了源代码的每一个部分以及它们之间的关系,能够本身在这里试一下astexplorer。
AST
是怎么来的?解析过程分为两个步骤:
Javascript
代码中的语法单元主要指如标识符(if/else、return、function)、运算符、括号、数字、字符串、空格等等能被解析的最小单元
[
{
"type": "Punctuator",
"value": "("
},
{
"type": "Identifier",
"value": "foo"
},
{
"type": "Punctuator",
"value": ","
},
{
"type": "Identifier",
"value": "bar"
},
{
"type": "Punctuator",
"value": ")"
},
{
"type": "Punctuator",
"value": "=>"
},
{
"type": "Identifier",
"value": "foo"
},
{
"type": "Punctuator",
"value": "+"
},
{
"type": "Identifier",
"value": "bar"
}
]
复制代码
语义分析则是将获得的词汇进行一个立体的组合,肯定词语之间的关系。考虑到编程语言的各类从属关系的复杂性,语义分析的过程又是在遍历获得的语法单元组,相对而言就会变得更复杂。
简单来讲语义分析既是对语句和表达式识别,这是个递归过程,在解析中,Babel
会在解析每一个语句和表达式的过程当中设置一个暂存器,用来暂存当前读取到的语法单元,若是解析失败,就会返回以前的暂存点,再按照另外一种方式进行解析,若是解析成功,则将暂存点销毁,不断重复以上操做,直到最后生成对应的语法树。
插件应用于babel
的转译过程,尤为是第二个阶段Transformation
,若是这个阶段不使用任何插件,那么babel
会原样输出代码。
babel
官方帮咱们作了一些预设的插件集,称之为preset
,这样咱们只须要使用对应的preset就能够了。每一年每一个preset
只编译当年批准的内容。 而babel-preset-env
至关于 es2015 ,es2016 ,es2017 及最新版本。
若是 plugin 是经过 npm 安装,能够传入 plugin 名字给 babel,babel 将检查它是否安装在node_modules
中
"plugins": ["babel-plugin-myPlugin"]
复制代码
也能够指定你的 plugin/preset 的相对或绝对路径。
"plugins": ["./node_modules/asdf/plugin"]
复制代码
若是两次转译都访问相同的节点,则转译将按照 plugin 或 preset 的规则进行排序而后执行。
例如:
{
"plugins": [
"transform-decorators-legacy",
"transform-class-properties"
]
}
复制代码
将先执行transform-decorators-legacy
再执行transform-class-properties
但 preset 是反向的
{
"presets": [
"es2015",
"react",
"stage-2"
]
}
复制代码
会按如下顺序运行: stage-2
, react
, 最后es2015
。
用babel-generator
经过 AST 树生成 ES5 代码
Babel
插件基础的东西讲了些,下面说下具体如何写插件。
先从一个接收了当前babel对象做为参数的function
开始。
export default function(babel) {
// plugin contents
}
复制代码
咱们常常会这样写
export default function({ types: t }) {
//
}
复制代码
接着返回一个对象,其visitor
属性是这个插件的主要访问者。
export default function({ types: t }) {
return {
visitor: {
// visitor contents
}
};
};
复制代码
visitor
中的每一个函数接收2个参数:path
和state
export default function({ types: t }) {
return {
visitor: {
CallExpression(path, state) {}
}
};
};
复制代码
咱们写一个简单的插件,把全部定义变量名为a
的换成b
, 先从astexplorer看下var a = 1
的 AST
{
"type": "Program",
"start": 0,
"end": 10,
"body": [
{
"type": "VariableDeclaration",
"start": 0,
"end": 9,
"declarations": [
{
"type": "VariableDeclarator",
"start": 4,
"end": 9,
"id": {
"type": "Identifier",
"start": 4,
"end": 5,
"name": "a"
},
"init": {
"type": "Literal",
"start": 8,
"end": 9,
"value": 1,
"raw": "1"
}
}
],
"kind": "var"
}
],
"sourceType": "module"
}
复制代码
从这里看,要找的节点类型就是VariableDeclarator
,下面开搞
export default function({ types: t }) {
return {
visitor: {
VariableDeclarator(path, state) {
if (path.node.id.name == 'a') {
path.node.id = t.identifier('b')
}
}
}
}
}
复制代码
咱们要把id
属性是 a 的替换成 b 就行了。可是这里不能直接path.node.id.name = 'b'
。若是操做的是object,就没问题,可是这里是 AST 语法树,因此想改变某个值,就是用对应的 AST 来替换,如今咱们用新的标识符来替换这个属性。
测试一下
import * as babel from '@babel/core';
const c = `var a = 1`;
const { code } = babel.transform(c, {
plugins: [
function({ types: t }) {
return {
visitor: {
VariableDeclarator(path, state) {
if (path.node.id.name == 'a') {
path.node.id = t.identifier('b')
}
}
}
}
}
]
})
console.log(code); // var b = 1
复制代码
例如咱们要实现把import { Button } from 'antd'
转成import Button from 'antd/lib/button'
经过对比 AST 发现,specifiers
里的type
和source
不一样。
// import { Button } from 'antd'
"specifiers": [
{
"type": "ImportSpecifier",
...
}
]
复制代码
// import Button from 'antd/lib/button'
"specifiers": [
{
"type": "ImportDefaultSpecifier",
...
}
]
复制代码
import * as babel from '@babel/core';
const c = `import { Button } from 'antd'`;
const { code } = babel.transform(c, {
plugins: [
function({ types: t }) {
return {
visitor: {
ImportDeclaration(path) {
const { node: { specifiers, source } } = path;
if (!t.isImportDefaultSpecifier(specifiers[0])) { // 对 specifiers 进行判断
const newImport = specifiers.map(specifier => (
t.importDeclaration(
[t.ImportDefaultSpecifier(specifier.local)],
t.stringLiteral(`${source.value}/lib/${specifier.local.name}`)
)
))
path.replaceWithMultiple(newImport)
}
}
}
}
}
]
})
console.log(code); // import Button from "antd/lib/Button";
复制代码
主要介绍了一下几个babel
的 API,和babel
编译代码的过程以及简单编写了一个babel
插件