babel能不能分析代碼而後按需polyfill ？

原文地址: github.com/yinxin630/b…
技術交流羣: fiora.suisuijiang.com/

先聊下 babel 與 polyfill

ES2015 標準已經發布三年了, 在項目中咱們會寫 ES2015(或者更高版本) 的代碼, 可是代碼最終運行的環境(瀏覽器)一般是不可控的, 所以須要將 ES2015 編譯爲低版本代碼, 來保證全部目標環境可運行

babel 就是用來將高版本編譯爲低版本的工具, 在不配置額外插件的狀況下, babel 僅僅是將 ES2015 的語法(例如for of)轉換, 而 ES2015 新增的類/方法(例如Set 或者 [1, 2].findIndex())會保持原樣

這時候就須要 polyfill 了, 須要在項目入口文件最開頭引入@babel/polyfill. 可是在項目中, 一般僅用到了有限的 polyfill 內容, 而最新版的@babel/polyfill包體積有 81.2k(gzipped 27.7k) 大小

那麼可不能夠只 polyfill 代碼中用到的內容呢?

假設有以下源碼:

const set = new Set(); // ES6 Set
set.add(1);
set.add(2);
set.add(3);

const arr = [1, 2, 3]; // ES6 for..of
for (const a of arr) {
    console.log(a);
}

console.log(arr.findIndex(x => x === 2));  // ES6 Array.prototype.findIndex
複製代碼

接下來試試不一樣的 polyfill 方案

@babel/plugin-transform-runtime

babeljs.io/docs/en/bab…

首先是使用 transfrom-runtime 這個插件, 它能夠僅對代碼中用到的類/靜態方法進行 polyfill, 可是對於原型鏈上新增的方法無效

NOTE: Instance methods such as "foobar".includes("foo") will not work since that would require modification of existing built-ins (you can use @babel/polyfill for that).

添加 babel 配置

// babel 配置
{
    "presets": [
        [
            "@babel/preset-env",
        ]
    ],
    "plugins": [
        [
            "@babel/plugin-transform-runtime",
            {
                "corejs": 2,
                "helpers": true,
                "regenerator": true,
                "useESModules": false
            }
        ]
    ]
}
複製代碼

編譯後:

"use strict";

var _interopRequireDefault = require("@babel/runtime-corejs2/helpers/interopRequireDefault");

var _set = _interopRequireDefault(require("@babel/runtime-corejs2/core-js/set"));

var set = new _set.default();
set.add(1);
set.add(2);
set.add(3);
var arr = [1, 2, 3];

for (var _i = 0; _i < arr.length; _i++) {
  var a = arr[_i];
  console.log(a);
}

console.log(arr.findIndex(function (x) {
  return x === 2;
}));
複製代碼

編譯後的代碼僅僅引入了 Set 實現, 可是 findIndex() 沒有 polyfill 若是你肯定不會使用任何原型鏈上新增的方法, 那麼 @babel/plugin-transform-runtime 會是一個不錯的選擇

@babel/preset-env + useBuiltIns

babeljs.io/docs/en/bab…

@babel/preset-env 支持你配置目標環境, 它的 useBuiltIns 選項, 有三個可選值 "usage" | "entry" | false(默認值)

This option adds direct references to the core-js module as bare imports. Thus core-js will be resolved relative to the file itself and needs to be accessible. You may need to specify core-js@2 as a top level dependency in your application if there isn't a core-js dependency or there are multiple versions.

useBuiltIns: 'entry'

該選項須要在項目中引入 @babel/polyfill, babel 會自動將 @babel/polyfill 分解爲更小的、僅目標環境須要的 polyfill 引用

NOTE: Only use require("@babel/polyfill"); once in your whole app. Multiple imports or requires of @babel/polyfill will throw an error since it can cause global collisions and other issues that are hard to trace. We recommend creating a single entry file that only contains the require statement.

首先要在源碼第一行添加 polyfill 引用

import '@babel/polyfill'
複製代碼

修改 babel 配置

// babel 配置
{
    "presets": [
        [
            "@babel/preset-env",
            {
                "targets": "Chrome 40",
                "useBuiltIns": "entry"
            }
        ]
    ]
}
複製代碼

編譯後:

"use strict";

require("core-js/modules/es6.array.copy-within");

require("core-js/modules/es6.array.fill");

require("core-js/modules/es6.array.find");

require("core-js/modules/es6.array.find-index");

require("core-js/modules/es6.array.from");

require("core-js/modules/es7.array.includes");

require("core-js/modules/es6.array.of");

require("core-js/modules/es6.array.sort");

require("core-js/modules/es6.array.species");

require("core-js/modules/es6.date.to-primitive");

require("core-js/modules/es6.function.has-instance");

require("core-js/modules/es6.map");

require("core-js/modules/es6.number.constructor");

require("core-js/modules/es6.object.assign");

require("core-js/modules/es7.object.define-getter");

require("core-js/modules/es7.object.define-setter");

require("core-js/modules/es7.object.entries");

require("core-js/modules/es6.object.freeze");

require("core-js/modules/es6.object.get-own-property-descriptor");

require("core-js/modules/es7.object.get-own-property-descriptors");

require("core-js/modules/es6.object.get-prototype-of");

require("core-js/modules/es7.object.lookup-getter");

require("core-js/modules/es7.object.lookup-setter");

require("core-js/modules/es6.object.prevent-extensions");

require("core-js/modules/es6.object.is-frozen");

require("core-js/modules/es6.object.is-sealed");

require("core-js/modules/es6.object.is-extensible");

require("core-js/modules/es6.object.seal");

require("core-js/modules/es7.object.values");

require("core-js/modules/es6.promise");

require("core-js/modules/es7.promise.finally");

require("core-js/modules/es6.reflect.apply");

require("core-js/modules/es6.reflect.construct");

require("core-js/modules/es6.reflect.define-property");

require("core-js/modules/es6.reflect.delete-property");

require("core-js/modules/es6.reflect.get");

require("core-js/modules/es6.reflect.get-own-property-descriptor");

require("core-js/modules/es6.reflect.get-prototype-of");

require("core-js/modules/es6.reflect.has");

require("core-js/modules/es6.reflect.is-extensible");

require("core-js/modules/es6.reflect.own-keys");

require("core-js/modules/es6.reflect.prevent-extensions");

require("core-js/modules/es6.reflect.set");

require("core-js/modules/es6.reflect.set-prototype-of");

require("core-js/modules/es6.regexp.constructor");

require("core-js/modules/es6.regexp.flags");

require("core-js/modules/es6.regexp.match");

require("core-js/modules/es6.regexp.replace");

require("core-js/modules/es6.regexp.split");

require("core-js/modules/es6.regexp.search");

require("core-js/modules/es6.regexp.to-string");

require("core-js/modules/es6.set");

require("core-js/modules/es6.symbol");

require("core-js/modules/es7.symbol.async-iterator");

require("core-js/modules/es6.string.code-point-at");

require("core-js/modules/es6.string.ends-with");

require("core-js/modules/es6.string.from-code-point");

require("core-js/modules/es6.string.includes");

require("core-js/modules/es7.string.pad-start");

require("core-js/modules/es7.string.pad-end");

require("core-js/modules/es6.string.raw");

require("core-js/modules/es6.string.repeat");

require("core-js/modules/es6.string.starts-with");

require("core-js/modules/es6.typed.array-buffer");

require("core-js/modules/es6.typed.int8-array");

require("core-js/modules/es6.typed.uint8-array");

require("core-js/modules/es6.typed.uint8-clamped-array");

require("core-js/modules/es6.typed.int16-array");

require("core-js/modules/es6.typed.uint16-array");

require("core-js/modules/es6.typed.int32-array");

require("core-js/modules/es6.typed.uint32-array");

require("core-js/modules/es6.typed.float32-array");

require("core-js/modules/es6.typed.float64-array");

require("core-js/modules/es6.weak-map");

require("core-js/modules/es6.weak-set");

require("core-js/modules/web.timers");

require("core-js/modules/web.immediate");

require("core-js/modules/web.dom.iterable");

require("regenerator-runtime/runtime");

var set = new Set();
set.add(1);
set.add(2);
set.add(3);
var arr = [1, 2, 3];

for (var _i = 0; _i < arr.length; _i++) {
  var a = arr[_i];
  console.log(a);
}

console.log(arr.findIndex(function (x) {
  return x === 2;
}));
複製代碼

編譯後的代碼自動引入的 Chrome 40 不支持的全部內容, 包括 Set 和 findIndex(), 它並不會去分析源碼用到的哪些內容

嘗試修改 targets 爲 Chrome 60, 編譯後:

"use strict";

require("core-js/modules/es6.array.sort");

require("core-js/modules/es7.object.define-getter");

require("core-js/modules/es7.object.define-setter");

require("core-js/modules/es7.object.lookup-getter");

require("core-js/modules/es7.object.lookup-setter");

require("core-js/modules/es7.promise.finally");

require("core-js/modules/es7.symbol.async-iterator");

require("core-js/modules/web.timers");

require("core-js/modules/web.immediate");

require("core-js/modules/web.dom.iterable");

const set = new Set();
set.add(1);
set.add(2);
set.add(3);
const arr = [1, 2, 3];

for (const a of arr) {
  console.log(a);
}

console.log(arr.findIndex(x => x === 2));
複製代碼

因爲 Chrome 60 已經支持 Set 和 findIndex() 了, 所以 polyfill 的內容並不包括它倆

useBuiltIns: 'usage'

該選項目前仍是實驗性的, 咱們來試試它打包後是怎樣的

首先要去掉源碼中的 import '@babel/polyfill'

修改 babel 配置:

{
    "presets": [
        [
            "@babel/preset-env",
            {
                "targets": "Chrome 40",
                "useBuiltIns": "usage"
            }
        ]
    ]
}
複製代碼

編譯後:

"use strict";

require("core-js/modules/es6.array.find-index");

require("core-js/modules/web.dom.iterable");

require("core-js/modules/es6.set");

var set = new Set();
set.add(1);
set.add(2);
set.add(3);
var arr = [1, 2, 3];

for (var _i = 0; _i < arr.length; _i++) {
  var a = arr[_i];
  console.log(a);
}

console.log(arr.findIndex(function (x) {
  return x === 2;
}));
複製代碼

哇, 看起來這彷佛就是我須要的! 但它是分析到我使用了 Array.protoptype.findIndex() 才添加 polyfill 的嗎? 來作個試驗看看

修改源碼:

String.prototype.findIndex = function() {}
const str = '';
str.findIndex(); // 調用 String.prototype.findIndex
複製代碼

此次我沒有去調用 Array 原型鏈的 findIndex, 並且調用了本身實現的 String 原型鏈的 findIndex

編譯後:

"use strict";

require("core-js/modules/es6.array.find-index");

String.prototype.findIndex = function () {};

var str = '';
str.findIndex();
複製代碼

😂原來它是直接匹配的方法名, 添加了同名的 polyfill

useBuiltIns 結論

useBuiltIns: 'entry' 是按目標環境去 polyfill 的, 不關心代碼中是否使用, 能夠保證在目標環境必定可用

useBuiltIns: 'usage' 目前仍是實驗性的配置, 它會分析代碼調用, 可是對於原型鏈上的方法僅僅按照方法名去匹配, 能夠獲得更小的 polyfill 體積. 可是它不會去分析代碼依賴的 npm 包的內容, 若是某個 npm 包是須要一些 polyfill 的, 那這些 polyfill 並不會被打包進去

爲何原型鏈上的方法不能根據是否用到, 而後按需去 polyfill 呢?

主要是由於 JavaScript 動態類型的特性, 有些變量/實例的類型是運行時才能肯定的, 而 babel 僅僅是對代碼的靜態編譯, 所以它並不能肯定 findIndex() 究竟是不是 Array.protoptype.findIndex(), 例如:

fetch('/api')
.then(res => res.json())
.then(data => data.findIndex)
複製代碼

data 的類型由運行時接口返回的內容決定, 因此 babel 不能實現原型鏈方法按需 polyfill

TypeScript 具有靜態類型, 能夠按需 polyfill 嗎?

結論是不能! 關於 polyfill 的討論能夠看看 github.com/Microsoft/T…

TypeScript 能夠用 --lib 參數指定要依賴的庫, 搭配 ts-polyfill 能夠對依賴的庫進行 polyfill, 可是指定依賴時不能詳細到某個方法, 只能 ESNext.Array

若是非要只 polyfill Set 和 findIndex 呢?

能夠手動引入 core-js 中相應的實現, 譬如:

import 'core-js/modules/es6.set.js';
import 'core-js/modules/es6.array.find-index.js';
複製代碼

不推薦這種作法, 除非追求最小的 polyfill 大小, 你必須清楚的知道項目中用到了哪些內容. 但在實際項目中, 尤爲多人開發的項目, 一般很難去控制