一、Babel 解决什么问题?
1、问题
浏览器无法运行 ECMAScript 2015
、JSX
、TypeScript
等语法编写的脚本代码。
ECMAScript 2015
:ECMAScript 在2015年发布新的 JavaScript 语法;JSX
:用在 React 框架中脚本语言;详细说明,看这里!TypeScript
: JavaScript 的扩展语法,用于数据类型、逻辑检查等;详细说明,看这里!
2、解决方案
Babel 可以把这些代码 转换成 浏览器可以运行的 JavaScript 代码。ES2015、TypeScript、JSX 等不仅可以提升开发效率,还可以解决原生JavaScript语法无法处理的一些编程问题。
二、运行原理简介
用 Babel 进行代码转换,需要涉及三个模块:【运行程序】 【配置】 【Plugins/Presets】。
- 运行程序:主要指 @babel/core 和 @babel/cli;
- 配置文件:转换中的一些特定选项的设定;
- Plugins、Presets :决定哪些代码需要被转换;
三、一个简单案例
用 ES2015 语法编写的项目,怎么用 Babel 转换成浏览器可以运行的代码?
- 新建项目文件夹:learn-babel;
- 新建文件夹
learn-babel/src
和 新建并复制下面代码到learn-babel/src/test.js
文件;
[1, 2, 3].map(n => n 1);
- 新建文件夹
learn-babel/lib
,用于放置转换后代码; - 新建配置文件
learn-babel/babel.config.json
,复制下面配置信息
{
"presets": [
"@babel/preset-env"
]
}
- 安装 Babel
cd learn-babel
npm install --save-dev @babel/core @babel/cli @babel/preset-env
- 转换代码(下面两种方式都可以)
# 方法一
./node_modules/.bin/babel src --out-dir lib
# 方法二
npx babel src --out-dir lib
- 查看结果
可以在 lib 目录下看到,有个新文件 test.js
生成,其中 箭头函数的新语法 被转换为 普通函数 。
"use strict";
[1, 2, 3].map(function (n) {
return n 1;
});
四、核心模块
1、@babel/core
包含 Babel 所有核心功能,还提供了API,可在代码中直接调用进行代码转换。
代码语言:txt复制# 安装
npm install --save-dev @babel/core
# 使用
const babel = require("@babel/core");
babel.transformSync("code", optionsObject);
2、@babel/cli
一个可执行程序,可以在终端中直接调用进行代码转换;
代码语言:txt复制# 安装
npm install --save-dev @babel/core @babel/cli
# 转换src目录下用ES2015语法代码,输出到lib目录
./node_modules/.bin/babel src --out-dir lib --presets=@babel/env
# ./node_modules/.bin/babel 可以用 npx 代替
npx src --out-dir lib --presets=@babel/env
五、Plugins
Plugins 和 Presets 告诉 Babel 应该转换哪些代码。一个Plugin实现一个代码转换功能,多个Plugin组合在一起就称之为Presets。
使用 plugin-transform-arrow-functions 插件转换 ES2015 中的箭头函数语法为浏览器可执行的代码。
代码语言:txt复制npm install --save-dev @babel/plugin-transform-arrow-functions
./node_modules/.bin/babel src --out-dir lib --plugins=@babel/plugin-transform-arrow-functions
- plugins - 官方文档
六、Presets
一个Plugin实现一个代码转换功能,多个Plugin组合在一起就称之为Presets。官方提供了 4个 Presets,可以直接使用。
1、preset-env
功能:用于转换 ES2015 所有语法。
代码语言:txt复制npm install --save-dev @babel/preset-env
./node_modules/.bin/babel src --out-dir lib --presets=@babel/env
- babel-preset-env - 官方文档
2、preset-react
功能 :用于 React 项目。
- 怎么 在React 项目中使用 Babel 来转换 JSX代码?
- babel-preset-react - 官方文档
3、preset-typescript
功能 :用于转换 TypeScript 代码。
- babel-preset-typescript - 官方文档
4、preset-flow
功能 :用于转换 flow 代码。
- babel-preset-flow - 官方文档
七、配置文件
1、分类
配置文件分为两种:基于项目的配置文件、基于文件的项目配置。
- 基于项目
Babel 7.x 版本开始,Babel运行时会默认以目录下的 babel.config.json 作为配置文件,或者其他可支持的后缀 .js
, .cjs
, .mjs
, 下面是.json
后缀的配置格式:
{
"presets": [...],
"plugins": [...]
}
- 基于文件,有两种使用情况:
- 文件名为
.babelrc.json
,还有其他可用后缀 :.babelrc
,.js
,.cjs
,.mjs
。 - 在
package.json
文件中配置 babel,如下:
{
"name": "my-package",
"version": "1.0.0",
"babel": {
"presets": [ ... ],
"plugins": [ ... ],
}
}
- .js 后缀的说明
JavaScript 配置文件可以导出一个对象,也可以导出一个函数,调用时将返回生成的配置。返回函数的配置被赋予了一些特殊的权力,因为它们可以访问 Babel 本身公开的 API。配置格式如下:
代码语言:txt复制module.exports = function (api) {
api.cache(true);
const presets = [ ... ];
const plugins = [ ... ];
return {
presets,
plugins
};
}
2、配置选项
配置文件的选项分为两个类型:
- 配置项目的相关属性。options - 官方文档
- 配置 Plugin 或 Preset 的相关属性,需要找对应文档查看哪些属性可以设置。
八、参考文档
- 学习Babel,从这里开始!