babel-preset-env

//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来分析具体的支持情况，所以，你可以用任何有效的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特定语法的环境

用外部数据例如：compat-table,来确定浏览器的支持情况。

我们会定期的跑build-data.js来更新plugins.json

参考：问题7

维护一个map在javascript特定语法与bable插件之间

目前存储在plugin-features.js
这样应该是被大多数人的要求所期待的，有很多的例子说插件集应该被分开，或者某一个插件不够足够独立(或不可能做到)。

babel支持所有的插件集的思想在babel-preset-latest被考虑进去

默认没有配置的表现同babel-preset-latest一样
不需要包含stage-x插件，env将提供所有的插件，支持到javascript最新的版本。

参考：问题14

确定最低的插件公共标准被包含在preset里

如果你target为IE8和chrome55，它将会包含ie8所需要的所有插件，你将来可能仍然会需要支持

支持target配置"node": "current"来解析当前运行额度node版本

例如，如果你bulid在node6上面，箭头函数没有被转换，如果运行在node0.12上面，将会被转

支持browsers配置就像自动加上前缀一样

利用browsers来声明支持的环境，通过设置参数，例如>1%, last 2 versions

参考：问题19
浏览器支持列表
browsers列出来在不同的浏览器上前端语言的支持情况，像工具比如autoprefixer style eslant-plugin-compat或者其他更多的

默认情况下，babel-preset-env会用browserlist config sources
例如，只需要对某个项目在兼容浏览器的最新两个版本以及IE10，仅仅需要这个条件下饿polyfills和plugins

.babelrc

{
    "presets": [
        ["env", {
            "useBuiltIns": true
        }]
    ]
}

browserslist

last 2 versions
IE 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.browsers），则目标将按照与targets明确定义的相同的方式合并targets.browsers。

安装

npm

nom install --save-dev babel-preset-env

or yarn

yarn add babel-preset-env --dev

使用

没有配置项将会运行所有转换

{
    "presets": ["env"]
}

选项

有关设置preset的更多信息，请参阅preset插件配置文档

targets

{[string]: number | string}, 默认为{}
提供环境版本的对象来支持
每个目标浏览器都需要一个数字或者一个字符串（我们建议在指定次要版本时使用字符串 node: "6.10"）。
环境比如：chrome,opera,edge,firefox,safari,ie,ios,android,node,electron.
通过运行build-data脚本从compat-table获取，产生以上数据。

targets.node

number | string | "current" | true
如果你想根据当前node版本编译，可以指定node: true或"node": "current",与"node":process.versions.node是一样的。

targets.browsers

Array<string> | string
使用browserslist查询使用浏览器(ex: last 2 versions, > 5%),浏览器的选择结果将会被显示的放到targets中。

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 插件都包含，有前缀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，如果