Vue項目中的preset-env, core-js, browserslist是干嘛的

前言
如題這三個東西,相信很多人都見過,也都會用會配置,但要是讓你說出個所以然來,恐怕還不是那么容易。

曾經(jīng)的我,一邊google一邊配置,只要能用就萬事大吉了,且每次google出來的似乎還跟上次的都有所不同,所以每次配置項目時,有差異的。然而卻很少去深究為啥?為啥這樣配也可以,那樣配也可以,那到底怎樣配置才是最佳的?

下面就來簡單說說我的理解,不對的地方歡迎指正。

名稱解釋
preset-env

從名稱看有個env,這里就是包含“環(huán)境”之意。

在preset-env出來之前,我們需要自己知道要用什么es6的特性,然后自己去babel的配置文件中加進(jìn)去,如:

{
  "plugins": [
      "@babel/plugin-transform-arrow-functions",
      "@babel/plugin-transform-classes",
      "@babel/plugin-transform-spread",
      ...
  ]
}
這樣做非常繁瑣,開發(fā)體驗也不好。再后來,后來就出現(xiàn)了@babel/preset-env。

@babel/preset-env可以通過target屬性配置一個目標(biāo)環(huán)境,babel會根據(jù)環(huán)境來轉(zhuǎn)換那些它不支持的語法,這樣就不需要我們一個一個的去自己加入所要支持的es6特性。如

{
    "presets": [
        ["@babel/preset-env", {
            "target": {
                "browsers": ["last 2 versions", "ie >= 7"]
            }
        }]
    ]
}
所以,@babel/preset-env的作用就是將常用的ES6特性放到一起了,然后添加一個可以配置的目標(biāo)環(huán)境,它自己決定要轉(zhuǎn)換那些ES6特性,這樣開發(fā)體驗就好很多。這樣雖然不需要我們配置ES6特性,但需要我們自己配置目標(biāo)環(huán)境,且這個環(huán)境只是babel自己知道,如果還有其他應(yīng)用,如ESLint,TS等等,其他應(yīng)用也需要讀取目標(biāo)環(huán)境來決定行為,還得配置……所以browserslist出現(xiàn)了。

browserslist

browserslist提供了一種項目共享的目標(biāo)環(huán)境配置,整個項目的babel、eslint,ts等都可以讀取到。如:

# Browsers that we support

[modern]
Firefox >= 53
Edge >= 15
Chrome >= 58
iOS >= 10.1

[legacy]
> 1%
它有自己的配置語法,一看就會,它有多種具體文檔:https://link.juejin.cn/?target=https%3A%2F%2Fgithub.com%2Fbrowserslist%2Fbrowserslist

有了browserslist的配置,我們就可以不用配置@babel/preset-env的target了。browserslist的配置可以寫在package.json里面也可以用獨立的.browserslistrc文件。

core-js

相信很多人一開始并不清楚core-js是干嘛的,因為我們已經(jīng)有babel了,為何還要core-js呢?如果你這么想,那就是有個關(guān)鍵的概念沒有搞清楚。一般babel只是用來將ES6+的語法轉(zhuǎn)為ES5,它并不處理ES6新增的API,如

const t = [1,2,3];
console.log(...t);
const x = t.includes(2);
console.log(x);
轉(zhuǎn)換后

"use strict";
var _console;
var t = [1, 2, 3];
(_console = console).log.apply(_console, t);
var x = t.includes(2);
console.log(x);
上面的擴展運算符是屬于語法的范疇,而數(shù)組的includes方法是屬于ES6新增的API,所以babel只是轉(zhuǎn)換了擴展運算符,而并沒有處理includes方法。所以當(dāng)我們在比較老舊的瀏覽器中運行時會報錯,如何讓這些老舊的瀏覽器也能認(rèn)識ES6新增的這些API,這就是core-js要做的事情了。

一起使用
core-js提供了各種“老舊瀏覽器”需要的ES6新API的實現(xiàn),browserslist提供了指定哪些“老舊瀏覽器”的功能,而@babel/preset-env提供了針對browserslist指定的老舊瀏覽器來轉(zhuǎn)換ES6到ES5,同時還能根據(jù)browserslist指定的環(huán)境從core-js中提取需要的ES6新增API的實現(xiàn)。簡單說@babel/preset-env使用core-js、browserslist通過適當(dāng)?shù)呐渲脕碇С指鞣N老舊的環(huán)境。

下面用一些簡單的代碼來演示如何一起使用,假設(shè)我們有如下index.js文件

init();

function init() {
    const p = new Map();
    const t = Object.entries({a:1,b:2})
    const y = [1,2,3].findIndex(x => x === 3);

    const t1 = new Promise((resolve) => {
        setTimeout(resolve, 1000, 3,2);
    });

    const obj = {
        maps: [p],
        printArr() {
            console.log(...t);
        },
        async p() {
            return t1;
        }
    };

    obj.printArr();
    obj.p().then(s => {console.log(s)});
}
.browserslistrc只指定ie11

ie 11
babel.config.json,指定usage方式引入core-js,以及指定使用的core-js版本

{
    "presets": [
        ["@babel/preset-env", {
            "useBuiltIns": "usage",
            "corejs": "3"
        }]
    ]
}





然后通過babel命令行轉(zhuǎn)譯

"use strict";
require("core-js/modules/es.symbol.js");
require("core-js/modules/es.symbol.description.js");
require("core-js/modules/es.symbol.iterator.js");
require("core-js/modules/es.array.from.js");
require("core-js/modules/es.array.slice.js");
require("core-js/modules/es.function.name.js");
require("core-js/modules/es.regexp.exec.js");
require("regenerator-runtime/runtime.js");
require("core-js/modules/es.array.iterator.js");
require("core-js/modules/es.map.js");
require("core-js/modules/es.object.to-string.js");
require("core-js/modules/es.string.iterator.js");
require("core-js/modules/web.dom-collections.iterator.js");
require("core-js/modules/es.object.entries.js");
require("core-js/modules/es.array.find-index.js");
require("core-js/modules/es.promise.js");

function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }

function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }

function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }

function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }

function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }

function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }

function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }

function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }

init();

function init() {
  var p = new Map();
  var t = Object.entries({
    a: 1,
    b: 2
  });
  var y = [1, 2, 3].findIndex(function (x) {
    return x === 3;
  });
  var t1 = new Promise(function (resolve) {
    setTimeout(resolve, 1000, 3, 2);
  });
  var obj = {
    maps: [p],
    printArr: function printArr() {
      var _console;

      (_console = console).log.apply(_console, _toConsumableArray(t));
    },
    p: function p() {
      return _asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee() {
        return regeneratorRuntime.wrap(function _callee$(_context) {
          while (1) {
            switch (_context.prev = _context.next) {
              case 0:
                return _context.abrupt("return", t1);

              case 1:
              case "end":
                return _context.stop();
            }
          }
        }, _callee);
      }))();
    }
  };
  obj.printArr();
  obj.p().then(function (s) {
    console.log(s);
  });
}
轉(zhuǎn)換后的代碼有點多,但這已經(jīng)是babel根據(jù)browserslist指定環(huán)境轉(zhuǎn)換的,我們可以看到babel提取了很多core-js中的實現(xiàn),如:require("core-js/modules/es.array.from.js")等……,還有一些函數(shù),如:_asyncToGenerator等我們稱為babel運行時(后面會說到)。要弄清楚轉(zhuǎn)譯后的文件為何這樣,我們得理解@babel/preset-env的配置項。

useBuiltIns

主要用于指定babel如何從core-js中提取合適的ES6新特性的實現(xiàn),有兩種模式:

usage:我們不需要在入口處導(dǎo)入core-js,babel會根據(jù)代碼中使用的ES6 API來決定提取哪些。

entry:我們通過import在入口引入core-js,babel會根據(jù)引入的core-js模塊來識別和拆分更細(xì)的導(dǎo)入,如

// 源文件
import "core-js/es/array";
import "core-js/proposals/math-extensions";

// 輸出
import "core-js/modules/es.array.unscopables.flat";
import "core-js/modules/es.array.unscopables.flat-map";
import "core-js/modules/esnext.math.clamp";
import "core-js/modules/esnext.math.deg-per-rad";
import "core-js/modules/esnext.math.degrees";
import "core-js/modules/esnext.math.fscale";
import "core-js/modules/esnext.math.rad-per-deg";
import "core-js/modules/esnext.math.radians";
import "core-js/modules/esnext.math.scale";
corejs用于指定core-js的版本,因為core-js有2和3的版本,這里babel默認(rèn)會使用2的版本,這里建議用3的版本。babel還建議指定core-js的minor版本,這樣能將最新實現(xiàn)的API包含進(jìn)來。默認(rèn)情況下,babel只會提取穩(wěn)定的API實現(xiàn),如果你想將還在提案階段的API也包含進(jìn)來,可以這樣配置:

{
    "corejs": { version: "3.8", proposals: true }
}
總的來說,useBuiltIns配置為usage,corejs配置為{ version: "3.8", proposals: true }會是大部分場景的選擇,不過后面還有更多的東西。。。

作者:生石灰 鏈接:https://juejin.cn/post/7088702716465119268

作者:生石灰


歡迎關(guān)注微信公眾號 :前端陽光