//tips:新手翻译,欢迎指正
以兼容的形式把babel-preset-env嵌入到babel里面
这将更容易的废弃无用的代码,并与剩下的代码同步生产使用,本来呢,我不确定它能够比我预料的时间更早的被生产使用,所以,它在一个单独的分支下面,但是现在,这个分离使我很痛苦!
babel-preset-env
babel preset将基于你的实际浏览器及运行环境,自动的确定babel插件及polyfills,转译ES2015及此版本以上的语言,
npm install babel-preset-env --save-dev
在没有配置项的情况下,babel-preset-env表现的同babel-preset-latest一样(或者可以说同babel-preset-es2015, babel-preset-es2016, and babel-preset-es2017结合到一起,表现的一致)
{ "presets": ["env"]}
你也可以通过配置polyfills和transforms来支持你所需要支持的浏览器,仅配置需要支持的语法来使你的打包文件更轻量级。
下面的例子,包括polyfills和代码,针对各个浏览器的最新的两个版本,以及safari的版本7及以上,针对以上两个条件的兼容情况进行代码转译。我们根据来分析具体的支持情况,所以,你可以用任何有效的browserslist查询格式来配置选项。
{ "presets": [ ["env", { "targets": { "browsers": ["last 2 versions", "safari >= 7"] } }] ]}
相同的,如果你的运行环境使node.js,你页可以配置babel-preset-env来支持一个特殊的node版本
{ "presets": [ ["env", { "targets": { "node": "6.10" } }] ]}
为了更佳的方便,可以使用"node": "current"根据你运行时的node.js版本,挑选需要的polyfills和transforms来支持。
{ "presets": [ ["env", { "targets": { "node": "current" } }] ]}
如何工作
确定支持ECMAScript特定语法的环境
用外部数据例如:,来确定浏览器的支持情况。
我们会定期的跑build-data.js来更新plugins.json参考:
维护一个map在javascript特定语法与bable插件之间
目前存储在plugin-features.js
这样应该是被大多数人的要求所期待的,有很多的例子说插件集应该被分开,或者某一个插件不够足够独立(或不可能做到)。babel支持所有的插件集的思想在babel-preset-latest被考虑进去
默认没有配置的表现同babel-preset-latest一样
不需要包含stage-x插件,env将提供所有的插件,支持到javascript最新的版本。参考:
确定最低的插件公共标准被包含在preset里
如果你target为IE8和chrome55,它将会包含ie8所需要的所有插件,你将来可能仍然会需要支持
支持target配置"node": "current"来解析当前运行额度node版本
例如,如果你bulid在node6上面,箭头函数没有被转换,如果运行在node0.12上面,将会被转
支持browsers配置就像自动加上前缀一样
利用来声明支持的环境,通过设置参数,例如>1%, last 2 versions
参考:
浏览器支持列表列出来在不同的浏览器上前端语言的支持情况,像工具比如 或者其他更多的默认情况下,babel-preset-env会用
例如,只需要对某个项目在兼容浏览器的最新两个版本以及IE10,仅仅需要这个条件下饿polyfills和plugins.babelrc
{ "presets": [ ["env", { "useBuiltIns": true }] ]}
browserslist
last 2 versionsIE 10
或者
package.json
"browserslist": "last 2 versions, ie 10"
browserslist config在下面几种情况下将会被忽略
目标浏览器是特殊的(targets.browsers)
配置ignoreBrowserslistConfig: true
目标合并
如果targets.browsers是正确的,browserslist config将会被忽略。在targets中配置的特殊浏览器将被合并到任何其他明确定义的目标浏览器上。如果合并,明确定义的目标将覆盖从其接收的相同目标targets.browsers。
如果目标浏览器不明确,程序将会带着浏览器列表搜寻browserslist文件或package.json。嗖嗖将会从进程的工作目录,或者配置文件的目录开始查找,一直到系统跟目录。如果同时找到一个browserslist文件和一个配置package.json,将抛出异常。
如果找到了一个browserslist配置,并且定义了其他目标(但不是),则目标将按照与targets明确定义的相同的方式合并targets.browsers。
安装
npm
nom install --save-dev babel-preset-env
or yarn
yarn add babel-preset-env --dev
使用
没有配置项将会运行所有转换
{ "presets": ["env"]}
选项
有关设置preset的更多信息,请参阅
targets
{[string]: number | string}
, 默认为{}
node: "6.10"
)。环境比如:chrome
,opera
,edge
,firefox
,safari
,ie
,ios
,android
,node
,electron
.通过运行从获取,产生以上数据。 targets.node
number | string | "current" | true
如果你想根据当前node版本编译,可以指定node: true
或"node": "current"
,与"node":process.versions.node
是一样的。 targets.browsers
Array<string> | string
spec
bool,默认为false
启用更多的规范兼容性,但会导致presets中的转换变慢,以此来支持他们。loose
bool,默认为false
为preset中的插件启用松散转换。modules
"amd" | "umd" | "systemjs" | "commonjs" | false, defaults to "commonjs".
启用es6模块语法转换为另一个模块类型。设为false不会转换。debug
bool,默认为false
输出使用的目标/插件,并在指定的版本来console.log。include
Array<string>, defaults to []
用于包含一组插件有效的选项包含:都包含,有前缀babel-plugin-transform-es2015-spread和无前缀transform-es2015-spread
内置插件,比如map set or Object.assign
如果当前的环境有问题,或者不支持或支持的不好的话,这个选项是很有用的。
例如,node4支持classes但不支持其扩展功能,如果super与扩展参数一起使用,那么transform-classes是需要包含的,因为不能用super其他的方式来扩展.note: include和exclude选项只工作于包含在preset里有的插件中。so,例如,包含proposal-do-expressions或者不包含proposal-function-bind将会报错。要使用preset里不包含的插件,请直接添加到您的配置中。exclude
Array<string>,默认为[]
用于排除和一处一组插件有效的配置同include选项。这个配置对于黑名单的翻译非常有用就像transform-regenerator,如果