babel-preset-env: a preset that configures Babel for you
转载
babel-preset-env is a new preset that lets you specify an environment and automatically enables the necessary plugins.
1. The problem
At the moment, several presets let you determine what features Babel should support:
babel-preset-es2015, babel-preset-es2016, etc.: incrementally support various versions of ECMAScript. es2015 transpiles what’s new in ES6 to ES5, es2016 transpiles what’s new in ES2016 to ES6, etc.
babel-preset-latest: supports all features that are either part of an ECMAScript version or at stage 4 (which basically means the same thing).
The problem with these presets is that they often do too much. For example, most modern browsers support ES6 generators. Yet, if you use babel-preset-es2015, generator functions will always be transpiled to complex ES5 code.
2. The solution
babel-preset-env works like babel-preset-latest, but it lets you specify an environment and only transpiles features that are missing in that environment.
Note that that means that you need to install and enable plugins and/or presets for experimental features (that are not part of babel-preset-latest), yourself.
On the plus side, you don’t need es20xx presets, anymore.
2.1 Browsers
For browsers you have the option to specify either:
- Browsers via browserslist query syntax. For example:
//Support the last two versions of browsers and IE 7+.
"babel": {
"presets": [
[
"env",
{
"targets": {
"browsers": ["last 2 versions", "ie >= 7"]
}
}
]
]
},
//Support browsers that have more than 5% market share.
"targets": {
"browsers": "> 5%"
}
//Fixed versions of browsers:
"targets": {
"chrome": 56
}
2.2 Node.js
If you compile your code for Node.js on the fly via Babel, babel-preset-env is especially useful, because it reacts to the currently running version of Node.js if you set the target "node" to "current":
"babel": {
"presets": [
[
"env",
{
"targets": {
"node": "current"
}
}
]
]
},
If you want to see this target in action, take a look at my GitHub repository async-iter-demo.
3. Additional options for babel-preset-env
This section gives a brief overview of additional options for babel-preset-env. For details, consult the [preset’s readme file] or doc for preset-env1.
3.1 modules (string, default: "commonjs")
This option lets you configure to which module format ES6 modules are transpiled:
- Transpile to popular module formats: "amd", "commonjs", "systemjs", "umd"
- Don’t transpile: false
3.2 include, exclude (Array of strings, default: [])
- include always enables certain plugins (e.g. to override a faulty native feature). It has the same effect as enabling plugins separately.
- exclude prevents certain plugins from being enabled.
3.3 useBuiltIns (boolean, default: false)
Babel comes with a polyfill for new functionality in the standard library. babel-preset-env can optionally import only those parts of the polyfill that are needed on the specified platform(s).
There are two ways of using the polyfill:
- core-js polyfills ES5, ES6+ as needed.
- Install polyfill: npm install core-js --save
- Activate polyfill: import "core-js";
- babel-polyfill polyfills core-js and the regenerator runtime (to emulate generators on ES5).
- Install polyfill: npm install babel-polyfill --save
- Activate polyfill: import "babel-polyfill";
Either of the two import statements is transpiled to an environment-specific sequence of more fine-grained imports. For example:
import "core-js/modules/es7.string.pad-start";
import "core-js/modules/es7.string.pad-end";
import "core-js/modules/web.timers";
import "core-js/modules/web.immediate";
import "core-js/modules/web.dom.iterable";
Things to note:
- You should activate the polyfill exactly once in your program, e.g. in a “main” module.
- useBuiltIns means that less code is downloaded to the browser (bundle sizes become smaller). However, it does not save RAM, because the polyfill only installs what is missing.
For more on polyfilling the standard library, consult chapter “Babel: configuring standard library and helpers” in “Setting up ES6”.
3.4 debug (boolean, default: false)
Logs the following information via console.log():
- Targeted environments
- Enabled transforms
- Enabled plugins
- Enabled polyfills
Check the next section for sample output.
3.5 Example
The following example is taken from the preset’s readme file:
{
"presets": [
[ "env", {
"targets": {
"safari": 10
},
"modules": false,
"useBuiltIns": true,
"debug": true
}]
]
}
Modules are not transpiled. We can, e.g., rely on webpack to handle imports and exports for us.
The debug output is as follows:
Using targets:
{
"safari": 10
}
Modules transform: false
Using plugins:
transform-exponentiation-operator {}
transform-async-to-generator {}
Using polyfills:
es7.object.values {}
es7.object.entries {}
es7.object.get-own-property-descriptors {}
web.timers {}
web.immediate {}
web.dom.iterable {}
最新文章
- 7 COMPELLING REASONS YOU NEED TO START THE BUSINESS YOU’VE ALWAYS WANTED
- POJ 3176 Cow Bowling
- 62. 链表重排[Reorder List]
- Android高级之Dalvik初识
- python3 split( ) not enough values to unpack(expceted 2, got 1)
- java实验报告三 敏捷开发与XP
- 【约瑟夫环变形】UVa 1394 - And Then There Was One
- Editplus 中将文本换行替换为<;p>;标签的正则表达式
- SharePoint 2010 Pop-Up Dialogs
- Java环境配置出现的问题及解决办法
- 《算法问题实战策略》-chaper8-动态规划法
- 基于年纪和成本(Age &; Cost)的缓存替换(cache replacement)机制
- virtio 简介
- eclipse修改默认workspace
- js实现消息滚动效果
- kettle基于时间戳增量更新
- jQuery使用(六):DOM操作之元素包裹、克隆DOM与data的综合应用
- PythonStudy——Pycharm 小技巧
- 使用jquery怎么选择有两个class的元素?
- [LeetCode]LinkedList Cycle