Babel 7 轉碼的正確姿勢

Babel 轉碼的配置是每位前端童鞋在日常工作中都會遇到的。剛開始我也是在網上搜索各種配置方法,升級到 Babel 7 的時候又折騰了一把,所以決定把自己的心得和理解記錄下來,希望能幫助到有需要的童鞋。

這裏呢不打算去講每一個詳細的配置項,畢竟官方文檔是最權威的。這篇主要是說下 Babel 7 轉碼中會涉及到的幾個主要庫以及他們之間的關係,還有不同的項目類型怎麼選擇配置方案和一些技巧。

涉及到的主要庫

首先呢先介紹一下 Babel 7 轉碼涉及到的“四大天王”:

  • @babel/preset-env
  • @babel/polyfill
  • @babel/runtime
  • @babel/plugin-transform-runtime

這四個庫有什麼作用和聯繫?相信很多童鞋跟我當初一樣總是有點分不清,下面就來逐一簡單解釋下,當然最詳細的內容還是要看官方文檔。

@babel/preset-env

這個是 Babel 轉碼的環境預設,會根據你設定的目標環境(例如要支持的瀏覽器版本範圍)來調整語法轉換規則和選擇環境墊片補丁,相比前任的優點是更智能,打包出來的體積也會更小。

@babel/polyfill

這個可以模擬基本完全的 ES6+ 環境(不能低於 Stage 4 的提案)。例如,新的 Class:Promise、Map,靜態方法:Array.from,新的原型方法:Array.prototype.includes 等。但要注意的是,使用 polyfill 的話是會污染全局的,因爲要提供原型方法的支持。

注意,這個庫在 Babel 7.4.0 後已被棄用,用下面的代替:

import 'core-js/stable';
import 'regenerator-runtime/runtime';

但思想是一樣的。

@babel/runtime

這個庫提供了一些轉碼過程中的一些幫助函數。簡單點來說就是在轉碼過程中,對於一些新語法,都會抽象一個個小的函數,在轉碼過程中完成替換。比如說我們寫了一個 class Circle {...},轉碼後就會變成這樣:

function _classCallCheck(instance, Constructor) {
  //...
}

var Circle = function Circle() {
  _classCallCheck(this, Circle);
};

所以在每次轉換 class 新語法的時候,都會用 _classCallCheck 這個函數去替換。

@babel/plugin-transform-runtime

這個是和上面的 @babel/runtime 配合使用的。延續上面的那個例子,如果你的項目有多個 js 文件裏面有 class 需要轉碼,那每個文件都會有一個重複的 _classCallCheck 函數定義,plugin-transform-runtime 的一個主要作用就是從統一的地方去引用這些幫助函數,消除代碼冗餘從而減少打包的體積:

var _classCallCheck = require("@babel/runtime/helpers/classCallCheck");

var Circle = function Circle() {
  _classCallCheck(this, Circle);
};

除此之外,他還提供了一個沙盒環境。如果我們使用 @babel/polyfill 來支持使用一些 ES6+ 的新特性的話(如:Promise、Map 等),會造成全局污染。通過配置 plugin-transform-runtime 的 corejs 選項可以開啓沙盒環境支持,在當前需要轉碼的文件中單獨引入所需的新功能。

安裝說明

接下來我們看看上面的四大天王怎麼安裝:

npm install --save @babel/runtime, @babel/polyfill
npm install --save-dev @babel/preset-env, @babel/plugin-transform-runtime

這裏也許有童鞋會有跟我當時同樣的疑問:@babel/runtime 不是打包轉碼過程中用的嗎,怎麼會安裝爲運行環境依賴呢?——還記得 plugin-transform-runtime 會從統一的地方去引用這些幫助函數嗎,這意味着這些代碼會在運行時執行,所以當然是運行時依賴啦。

然後這裏給大家提供一個小技巧。有時我們會安裝配置 @babel/preset-stage-x 去使用一些新的提案,當在 Babel 7 中這些 preset-stage-x 已經被棄用了,我們必須一個個的安裝所需的插件,還得去改 .babelrc 的配置,挺煩的,怎麼簡化呢?我們可以用下面的方法去簡化安裝,比如 stage-2:

  1. 首先:npm install --save-dev @babel/preset-stage-2
  2. 然後:npx babel-upgrade --write --install

這樣就搞定了。babel-upgrade 這個工具會自動幫你安裝所需的插件,並且把 package.json 和 .babelrc 文件相關的地方都改好,非常好用!

不同項目類型的配置建議

這裏我們主要分爲 npm 庫項目和業務項目來建議配置,僅供大家參考。當然首先 preset-env 是都要安裝的,然後根據你的目標環境做好配置。

npm 庫項目

這個簡單點來說就是你寫了一個第三方庫來給別人使用的,runtime 和 plugin-transform-runtime 肯定是都要安裝上的。特別注意 polyfill 不要安裝,我的建議是:由業務項目來負責墊片補丁,因爲 polyfill 會污染全局。

業務項目

這個就是我們的具體業務項目如網站啦什麼的。那麼 runtime、plugin-transform-runtime、和 polyfill 都要安裝上,並且 @babel/preset-env 要配置上 useBuiltIns: 'entry',這是爲了在項目入口文件上根據目標環境來智能選擇導入哪些 polyfill 而不是全部導入,這是 preset-env 會幫你做的事情(具體請參考 polyfill 文檔),最後別忘記了在入口文件上 import '@babel/polyfill'

以上即是我總結的 Babel 7 轉碼姿勢,如果對本篇有疑問或建議,歡迎在 這裏 提出。

歡迎 star 和關注我的 JS 博客:小聲比比 Javascript

參考資料

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章