如何写好.babelrc？Babel的presets和plugins配置解析

2017-08-09 15:14:52

什么是Babel

The compiler for writing next generation JavaScript.

官网是这么说的，翻译一下就是下一代JavaScript 语法的编译器。

作为前端开发，由于浏览器的版本和兼容性问题，很多JavaScript的新的方法都不能使用，等到可以大胆使用的时候，可能已经过去了好几年。Babel就因此而生，它可以让你放心使用大部分的JavaScript的新的标准的方法，然后编译成兼容绝大多数的主流浏览器的代码。

在升级到了Babel6.x版本之后，所有的插件都是可插拔的。这也意味着你安装了Babel之后，是不能工作的，需要配置对应的.babelrc文件才能发挥完整的作用。下面就对Babel的presets和plugins配置做一个简单解析。

所有配置根据官方文档提供，更新时间：2016-12-05。

预设(presets)

使用的时候需要安装对应的插件，对应babel-preset-xxx，例如下面的配置，需要npm install babel-preset-es2015。

{  "presets": ["es2015"]}

env

{  "presets": ["env", options]}

最近新增的一个选项，有以下options选择。

targets: { [string]: number }，默认{}

需要支持的环境，可选例如：chrome, edge, firefox, safari, ie, ios, node，甚至可以制定版本，如node: 6.5。也使用node: current代表使用当前的版本。

browsers: Array | string，默认[]

浏览器列表，使用的是browserslist，可选例如：last 2 versions, > 5%。

loose: boolean，默认false

是否使用宽松模式，如果设置为true，plugins里的插件如果允许，都会采用宽松模式。

debug: boolean，默认false

编译是否会去掉console.log。

whitelist: Array，默认[]

设置一直引入的plugins列表。

es2015/es2016/es2017/latest

{  "presets": ["es2015"]}
es2015

使用es2015的，也就是我们常说的es6的相关方法，简单翻译如下，更多细节可以参看文档。

  • check-es2015-constants // 检验const常量是否被重新赋值

  • transform-es2015-arrow-functions // 编译箭头函数

  • transform-es2015-block-scoped-functions // 函数声明在作用域内

  • transform-es2015-block-scoping // 编译const和let

  • transform-es2015-classes // 编译class

  • transform-es2015-computed-properties // 编译计算对象属性

  • transform-es2015-destructuring // 编译解构赋值

  • transform-es2015-duplicate-keys // 编译对象中重复的key，其实是转换成计算对象属性

  • transform-es2015-for-of // 编译for...of

  • transform-es2015-function-name // 将function.name语义应用于所有的function

  • transform-es2015-literals // 编译整数(8进制/16进制)和unicode

  • transform-es2015-modules-commonjs // 将modules编译成commonjs

  • transform-es2015-object-super // 编译super

  • transform-es2015-parameters // 编译参数，包括默认参数，不定参数和解构参数

  • transform-es2015-shorthand-properties // 编译属性缩写

  • transform-es2015-spread // 编译展开运算符

  • transform-es2015-sticky-regex // 正则添加sticky属性

  • transform-es2015-template-literals // 编译模版字符串

  • transform-es2015-typeof-symbol // 编译Symbol类型

  • transform-es2015-unicode-regex // 正则添加unicode模式

  • transform-regenerator // 编译generator函数

总结：常用的都覆盖了，并不需要太关心内容，如果使用某些还不支持的语法导致报错，可以回头查一下支持的列表。

es2016

使用es2016的相关插件，也就是es7，更多细节可以参看文档。

  • transform-exponentiation-operator // 编译幂运算符

es2017

使用es2017的相关插件，也就是es8？，更多细节可以参看文档。

  • syntax-trailing-function-commas // function最后一个参数允许使用逗号

  • transform-async-to-generator // 把async函数转化成generator函数

latest

latest是一个特殊的presets，包括了es2015，es2016，es2017的插件（目前为止，以后有es2018也会包括进去）。

react

react是一个比较特别的官方推荐的presets，大概是因为比较火吧。加入了flow，jsx等语法，具体可以看文档。

stage-x(stage-0/1/2/3/4)

stage-x和上面的es2015等有些类似，但是它是按照JavaScript的提案阶段区分的，一共有5个阶段。而数字越小，阶段越靠后，存在依赖关系。也就是说stage-0是包括stage-1的，以此类推。

stage-4

已完成的提案，与年度发布的release有关，包含2015年到明年正式发布的内容。例如，现在是2016年，stage-4应该是包括es2015，es2016，es2017。经过测试，babel-preset-stage-4这个npm包是不存在的，如果你单纯的需要stage-4的相关方法，需要引入es2015~es2017的presets。

stage-3

除了stage-4的内容，还包括以下插件，更多细节请看文档。

  • transform-object-rest-spread // 编译对象的解构赋值和不定参数

  • transform-async-generator-functions // 将async generator function和for await编译为es2015的generator。

stage-2

除了stage-3的内容，还包括以下插件，更多细节请看文档。

  • transform-class-properties // 编译静态属性(es2015)和属性初始化语法声明的属性(es2016)。

stage-1

除了stage-2的内容，还包括以下插件，更多细节请看文档。

  • transform-class-constructor-call // 编译class中的constructor，在Babel7中会被移除

  • transform-export-extensions // 编译额外的exprt语法，如export * as ns from "mod";细节可以看这个

stage-0

除了stage-1的内容，还包括以下插件，更多细节请看文档。

  • transform-do-expressions // 编译do表达式

  • transform-function-bind // 编译bind运算符，也就是::

插件(plugins)

其实看了上面的应该也明白了，presets，也就是一堆plugins的预设，起到方便的作用。如果你不采用presets，完全可以单独引入某个功能，比如以下的设置就会引入编译箭头函数的功能。

{  "plugins": ["transform-es2015-arrow-functions"]}

那么，还有一些方法是presets中不提供的，这时候就需要单独引入了，介绍几个常见的插件。

transform-runtime

{  "plugins": ["transform-runtime", options]}

主要有以下options选择。

helpers: boolean，默认true

使用babel的helper函数。

polyfill: boolean，默认true

使用babel的polyfill，但是不能完全取代babel-polyfill。

regenerator: boolean，默认true

使用babel的regenerator。

moduleName: string，默认babel-runtime

使用对应module处理。

这里的options一般不用自己设置，用默认的即可。这个插件最大的作用主要有几下几点：

  • 解决编译中产生的重复的工具函数，减小代码体积

  • 非实例方法的poly-fill，如Object.assign，但是实例方法不支持，如"foobar".includes("foo")，这时候需要单独引入babel-polyfill

更多细节参见文档。

transform-remove-console

{  "plugins": ["transform-remove-console"]}

使用这个插件，编译后的代码都会移除console.*，妈妈再也不用担心线上代码有多余的console.log了。当然很多时候，我们如果使用webpack，会在webpack中配置。

这也告诉我们，Babel不仅仅是编译代码的工具，还能对代码进行压缩，也许有一天，你不再需要代码压缩的插件了，因为你有了Babel！

自定义预设或插件

Babel支持自定义的预设(presets)或插件(plugins)。如果你的插件在npm上，可以直接采用这种方式"plugins": ["babel-plugin-myPlugin"]，当然，你也可以缩写，它和"plugins": ["myPlugin"]是等价的。此外，你还可以采用本地的相对路径引入插件，比如"plugins": ["./node_modules/asdf/plugin"]。

presets同理。

plugins/presets排序

也许你会问，或者你没注意到，我帮你问了，plugins和presets编译，也许会有相同的功能，或者有联系的功能，按照怎么的顺序进行编译？答案是会按照一定的顺序。

  • 具体而言，plugins优先于presets进行编译。

  • plugins按照数组的index增序(从数组第一个到最后一个)进行编译。

  • presets按照数组的index倒序(从数组最后一个到第一个)进行编译。因为作者认为大部分会把presets写成["es2015", "stage-0"]。具体细节可以看

    • 精彩推荐

    • 2020-03-14 23:39:59

      vuetify和@nuxt/vuetify icon 之我见

      vuetify中v-icon,貌似默认支持 Material Design Icons, Material Icons, Font Awesome 4 and Font Awesome 5， 我自己单独引入了vuetify 用哪一个图标都没有问题。但是用了@nuxt/vuetify只能用mdi-home这样的。不知道因为啥。肯定是封装后，封装成一个了。 但是我修改vuetify的设置，哪一个图标也都能用。哎，不过多研究了。

    • 2020-03-16 15:57:53

      nuxtjs中单独引入Message组件的问题

      // 引入elementUIimport { Message } from 'element-ui';//由于Message组件并没有install 方法供Vue来操作的，是直接返回的，因此按照官方文档单独引入的方法是//会报错的，需要给 Message 添加 install 方法Message.install = function (Vue, options) {Vue.prototype.$message = Message}Vue.use(Message )//消息提示

    • 2020-03-16 16:03:20

      css的var()函数

      　随着sass，less预编译的流行，css也随即推出了变量定义var函数。var()函数，就如同sass和less等预编译软件一样，可以定义变量并且进行对应的使用。

    • 2020-03-16 16:52:05

      对icomoon的误解，以及最快速的使用

      此时需要注意顶部第一个选项，Quick Usage，一定要打开，Enable Quick Usage，谁让咱英语不好呢，这个时候会出现一个css连接，直接引用就好了，就可以随意使用图标了，引入这一个css就能实现我们的功能，省区引入太多文件的烦恼，你可以在浏览器打开这个css，可以看到里面把我们所用的文件整成base64了。所以挺好用的。

    • 2020-03-17 09:47:05

      video标签视频不自动播放的问题

      添加 muted 属性，就可以通过地址栏进入网页的时候自动播放了，手机端还是有的有限制的，比如iphone浏览器，就不行，苹果手机为了保护用户的流量和用户的意愿，是禁止自动播放的，必须有手动触发。

    • 2020-03-17 14:21:31

      nuxt+pm2 自动化部署及打包后文件自动上传阿里云 oss（精华）

      部署nuxtjs，这一篇文章就够了，pm2 代码自动发布依赖于 git 工具，先将 ssh 密钥配置再你的代码仓库（github 或者 gitLab），具体操作自行 google 或者点击github 配置 ssh。 使用 ssh 密钥链接服务器 s $ ssh-copy-id root@1.2.3.4 # 把本机的 SSH 秘钥添加至服务器，配置成功后，以后就不需要再执行这条 SSH 命令了

    • 2020-03-18 21:15:34

      使用canvas画布解决百度地图自定义图层全球连续显示问题

          基于百度地图的Web API进行自定义图层叠加时，默认的图层只能叠加到全球范围以内，即经度范围为[-180, 180]，而无法将图层叠加到默认的全球范围以外，即经度范围超出了[-180, 180]之后，经纬度坐标会自动回归到(0, 0)，而导致在地图拖拽时全球以外无法连续显示想要的图层，此时可以基于百度地图的自定义图层将经纬度坐标转为像素点使用画布canvas来解决该问题。解决后效果如下图所示： ———————————————— 版权声明：本文为CSDN博主「宏伟杰作」的原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接及本声明。 原文链接：https://blog.csdn.net/u011284073/article/details/80549950