The transform-runtime transformer plugin does three things:
Automatically requires @babel/runtime/regenerator when you use generators/async functions (toggleable with the regenerator option).
Can use core-js for helpers if necessary instead of assuming it will be polyfilled by the user (toggleable with the corejs option)
Automatically removes the inline Babel helpers and uses the module @babel/runtime/helpers instead (toggleable with the helpers option).
What does this actually mean though? Basically, you can use built-ins such as Promise, Set, Symbol, etc., as well use all the Babel features that require a polyfill seamlessly, without global pollution, making it extremely suitable for libraries.
@babel/preset-env
@babel/preset-env
主要的功能是依据项目经过babel
编译构建后产生的代码所对应运行的目标平台。@babel/preset-env
内部依赖了很多插件:@babel/plugin-transform-*
。这些插件的工作主要就是babel
在处理代码的过程当中对于新的 ES 语法的转换,将高版本的语法转化为低版本的写法。例如@babel/plugin-transform-arrow-function
是用来转化箭头函数语法的。基本的配置方法:
对于
web
侧的项目或者 基于Electron
的项目,一般会搭配着.browserlistrc
(或package.json
里的browserslist
字段) 来使用(确定最终构建平台)。相关 options 配置
useBuiltIns
这个配置选项也决定了
@babel/preset-env
如何去引用 polyfills。当这个配置选项为:usage
或entry
,@babel/preset-env
会直接建立起对于core-js
相关 module 的引用。因此这也意味着core-js
会被解析为对应的相对路径同时需要确保core-js
在你的项目当中已经被安装了。因为从
@babel/polyfill
从 7.4.0 版本开始就被弃用了,因此推荐直接配置corejs
选项,并在项目当中直接安装core-js
。useBuiltIns: 'entry'
使用这种方式的配置需要在你的业务代码当中注入:
在
babel
处理代码的过程当中,会引入一个新的插件,同时@babel/preset-env
会根据目标平台,例如target
当中的配置,或者是.browserlistrc
等来引入对应平台所需要的polyfill
:In:
Out(different based on environment):
注:其实这里的 useBuiltIns:
entry
的配置以及需要在业务代码当中需要注入core-js
和regenerator-runtime/runtime
,在业务代码当中注入对应的 package 从使用上来讲更多的是起到了占位的作用,由@babel/preset-env
再去根据不同的目标平台去引入对应所需要的polyfill
文件同时在使用的过程中,如果是
import 'core-js'
那么在处理的过程当中会引入所有的ECMAScript
特性的 polyfill,如果你只希望引入部分的特性,那么可以:In:
Out:
useBuiltIns: 'usage'
自动探测代码当中使用的新的特性,并结合目标平台来决定引入对应新特性的
polyfill
,因此这个配置是会最大限度的去减少引入的polyfill
的数量来保证最终生成的bundler
体积大小。不过需要注意的是:由于
babel
处理代码本来就是一个非常耗时的过程,因此在我们实际的项目当中一般是对于node_modules
当中的package
进行exclude
配置给忽略掉的,除非是一些明确需要走项目当中的babel
编译的package
会单独的去include
,所以useBuiltIns: 'usage'
这种用法的话有个风险点就是node_modules
当中的第三方包在实际的编译打包处理流程当中没有被处理(例如有些package
提供了 esm 规范的源码,同时package.json
当中也配置了module
字段,那么例如使用webpack
这样的打包工具的话会引入module
字段对应的入口文件)同时,如果使用
useBuiltIns: 'usage'
配置的话。是会在每个文件当中去引入相关的polyfill
的,所以这里如果不借助webpack
这种打包工具的话,是会造成代码冗余的。useBuiltIns: false
Don't add polyfills automatically per file, and don't transform import "core-js" or import "@babel/polyfill" to individual polyfills.
corejs
corejs
的配置选项需要搭配着useBuiltIns: usage
或useBuiltIns: entry
来使用。默认情况下,被注入的 polyfill 都是稳定的已经被纳入ECMAScript
规范当中的特性。如果你需要使用一些 proposals 当中的 feature 的话,那么需要配置:@babel/plugin-transform-runtime
出现的背景:
Babel
在编译处理代码的过程当中会使用一些 helper 辅助函数,例如_extend
。这些辅助函数一般都会被添加到每个需要的被处理的文件当中。因此
@babel/plugin-transform-runtime
所要解决的问题就是将所有对于需要这些 helper 辅助函数的引入全部指向@babel/runtime/helpers
这个 module 当中的辅助函数,而不是给每个文件都添加对应 helper 辅助函数的内容。另外一个目的就是去创建一个沙盒环境。因为如果你直接引入
core-js
,或者@babel/polyfill
的话,它所提供的 polyfill,例如Promise
,Set
,Map
等,是直接在全局环境下所定义的。因此会影响到所有使用到这些 API 的文件内容。所以如果你是写一个 library 的话,最好使用 @babel/plugin-transform-runtime 来完成相关 polyfill 的引入,这样能避免污染全局环境。这个插件所做的工作其实也是引用
core-js
相关的模块来完成polyfill
的功能。最终所达到的效果和使用@babel/polyfill
是一样的。配置方法:
The plugin defaults to assuming that all polyfillable APIs will be provided by the user. Otherwise the corejs option needs to be specified.
需要注意的是不同
corejs
版本提供的 helpers 有一些功能上的差异:corejs: 2
仅支持全局的定义,例如Promise
,和一些静态方法,例如Array.from
,实例上的方法是是不支持的,例如[].includes
。不过corejs: 3
是支持实例上的方法的。默认情况下,
@babel/plugin-transform-runtime
是不会引入对于 proposals 的 polyfill 的,如果你是使用corejs: 3
的话,可以通过配置proposal: true
来开启这个功能。npm install --save @babel/runtime
npm install --save @babel/runtime-corejs2
npm install --save @babel/runtime-corejs3
技术实现细节
The transform-runtime transformer plugin does three things:
Automatically requires @babel/runtime/regenerator when you use generators/async functions (toggleable with the regenerator option).
Can use core-js for helpers if necessary instead of assuming it will be polyfilled by the user (toggleable with the corejs option)
Automatically removes the inline Babel helpers and uses the module @babel/runtime/helpers instead (toggleable with the helpers option).
What does this actually mean though? Basically, you can use built-ins such as Promise, Set, Symbol, etc., as well use all the Babel features that require a polyfill seamlessly, without global pollution, making it extremely suitable for libraries.
Some tips
如果使用
@babel/preset-env
走useBuiltIns: usage
搭配browserlist
的这种polyfill
的方式的话,polyfill
是会污染全局的(entry
模式也是污染全局)。不过这种配置的方式会依据目标打包平台来一定程度上减少不需要被加入到编译打包流程的polyfill
的数量,因此这种方式也对应的能较少 bundle 最终的体积大小。如果是走
@babel/plugin-transform-runtime
插件的polyfill
的话不会污染全局。但是这个插件没法利用browserlist
的目标平台配置的策略。因此在你代码当中只要是使用了ES6+
的新 api,一律都会引入对应的polyfill
文件(而不考虑这个新的 api 是否被目标浏览器已经实现了),这样也会造成 bundle 体积增大。针对这个问题,官方也尝试提供一个新的babel-polyfills
package,以及策略去解决类似的问题。详见对应的文档以及issue相关文档
@babel/plugin-transform-runtime
polyfill还是transform-runtime