[转]babel教程(代码片段)

前端开发 前端开发     2022-11-11     292

关键词:

在前端开发领域,浏览器兼容性问题从来不曾消失。除了 CSS,我们还要面对 JavaScript 的兼容性问题。

不同的浏览器讲着不同的 JavaScript 语言,不同的浏览器版本同样讲着不同的 JavaScript 语言。

你用了 JavaScript 的 A 特性,能够在 B 浏览器上正常运行,却在 C 浏览器的 D 版本上报错。

这正是 Babel.js 要解决的问题。更进一步,它能够让所有浏览器上都还不能正常运行的特性正常运行在所有浏览器上。

也因此,Babel 项目非常庞大,而且在不断地更新、调整,这意味着,一篇教程不可能囊括所有 - 当然,我也没那种打算。

本文基于 babel 7.0.0-beta.39。

babel-cli

babel-cli 是 babel 提供的命令行工具,用于命令行下编译我们的源代码 - 至于脚本语言用“编译”一词是否合适,我们且留给他人去论证。

这里假定我们已经初始化一个项目。

执行如下命令可以在项目下安装 babel-cli

npm install --save-dev @babel/core @babel/cli

嗯?怎么不是 npm install --save-dev babel-cli@ 符号又是什么意思?这正是 babel 7 的一大调整,从原来的 babel-xx 的包命名格式迁移到域内包(scoped package)。如果你有兴趣,可以阅读 babel 博客上重命名包名称的说明

假定我们的项目下有一个 babel.test.js 文件,内容是:

let fun = () => console.log(‘hello babel.js‘)

我们试试运行 npx babel babel.test.js

$ npx babel babel.test.js
let fun = () => console.log(‘hello babel.js‘);

还是原来的代码,没有任何变化。说好的编译呢?

这个调整则是在 babel 6 里发生的。Babel 6 做了大量模块化的工作,将原来集成一体的各种编译功能分离出去,独立成插件。这意味着,默认情况下,当下版本的 babel 不会编译代码。

babel 插件

换句话说,我们要将上面的箭头函数编译成 ES5 函数,需要额外安装 babel 插件。

首先,安装 @babel/plugin-transform-arrow-functions

npm install --save-dev @babel/plugin-transform-arrow-functions

然后,在命令行编译时指定使用该插件:

$ npx babel babel.test.js --plugins @babel/plugin-transform-arrow-functions
let fun = function () 
  return console.log(‘hello babel.js‘);
;

编译成功。

配置文件 .babelrc

随着各种新插件的加入,我们的命令行参数只会越来越长。

这时,我们可以新建一个 .babelrc 文件,把各种命令行参数统一到其中。

比如,要配置前面提到过的箭头函数插件:


  "plugins": ["@babel/plugin-transform-arrow-functions"]

之后,在命令行只要运行 npx babel babel.test.js 即可,babel 会自动读取 .babelrc 里的配置并应用到编译中:

$ npx babel babel.test.js
let fun = function () 
  return console.log(‘hello babel.js‘);
;

babel 套餐

我们有一个项目,页面要求支持 IE 10,但 IE 10 不支持箭头函数、classconst,可是你喜欢用这些新增的 JavaScript 语法,你在项目里写了这么一段代码:

const alertMe = (msg) => 
  window.alert(msg)

class Robot 
  constructor (msg) 
    this.message = msg
  
  say () 
    alertMe(this.message)
  

const marvin = new Robot(‘hello babel‘)

显然,在 IE 10 下这段代码报错了。

好消息是,babel 有各类插件满足你的上述需求。

我们来安装相应的插件:

$ npm install --save-dev @babel/plugin-transform-arrow-functions @babel/plugin-transform-block-scoping @babel/plugin-transform-classes

接着,将它们加入 .babelrc 配置文件中:


  "plugins": [
    "@babel/plugin-transform-arrow-functions",
    "@babel/plugin-transform-block-scoping",
    "@babel/plugin-transform-classes"
    ]

然后运行 npx babel babel.test.js,就有编译结果了:

var _createClass = function ()  function defineProperties(target, props)  for (var i = 0; i < props.length; i++)  var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor);   return function (Constructor, protoProps, staticProps)  if (protoProps) defineProperties(Constructor.prototype, protoProps); if (staticProps) defineProperties(Constructor, staticProps); return Constructor; ; ();

function _classCallCheck(instance, Constructor)  if (!(instance instanceof Constructor))  throw new TypeError("Cannot call a class as a function");                              

var alertMe = function (msg)                
  window.alert(msg);                         
;                                           

var Robot = function ()                     
  function Robot(msg)                       
    _classCallCheck(this, Robot);            

    this.message = msg;                      
                                            

  _createClass(Robot, [                     
    key: ‘say‘,                              
    value: function say()                   
      alertMe(this.message);                 
                                            
  ]);                                       

  return Robot;                              
();                                         

var marvin = new Robot(‘hello babel‘);   

只是,这样安装插件、配置 .babelrc 的过程非常乏味,而且容易出错。通常,我们不会关心到具体的某个 ES2015 特性支持情况这个层面,我们更关心浏览器版本这个层面。

你说,我不想关心 babel 插件的配置,我只希望,给 babel 一个我想支持 IE 10 的提示,babel 就帮我编译出能在 IE 10 上正常运行的 JavaScript 代码。

欢迎 @babel/preset-env

等等,Preset 是什么?前面我们已经认识了插件,那么不妨把 Preset 理解为套餐,每个套餐里打包了不同的插件,这样安装套餐就等于一次性安装各类 babel 插件。

我们来看看怎样使用 @babel/preset-env

首先在项目下安装:

$ npm install --save-dev @babel/preset-env

然后修改 .babelrc


  "presets": ["@babel/preset-env"]

运行 npx babel babel.test.js,输出结果如下:

‘use strict‘;

var _createClass = function ()  function defineProperties(target, props)  for (var i = 0; i < props.length; i++)  var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor);   return function (Constructor, protoProps, staticProps)  if (protoProps) defineProperties(Constructor.prototype, protoProps); if (staticProps) defineProperties(Constructor, staticProps); return Constructor; ; ();

function _classCallCheck(instance, Constructor)  if (!(instance instanceof Constructor))  throw new TypeError("Cannot call a class as a function");  

var alertMe = function alertMe(msg) 
  window.alert(msg);
;

var Robot = function () 
  function Robot(msg) 
    _classCallCheck(this, Robot);

    this.message = msg;
  

  _createClass(Robot, [
    key: ‘say‘,
    value: function say() 
      alertMe(this.message);
    
  ]);

  return Robot;
();

var marvin = new Robot(‘hello babel‘);

Wow,与前面辛苦配置各种插件后的输出结果几乎一模一样。

可是,我们还没告诉 babel 我们要支持 IE 10 的,为什么它却好像预知一切?

我们来看 babel-preset-env 的一段文档:

Without any configuration options, babel-preset-env behaves exactly the same as babel-preset-latest (or babel-preset-es2015, babel-preset-es2016, and babel-preset-es2017 together).

默认情况下,babel-preset-env 等效于三个套餐,而不巧我们前面安装的几个插件已经囊括在 babel-preset-es2015 中。

那么,如果我只想支持最新版本的 Chrome 呢?

这时我们可以调整 .babelrc 的配置:


  "presets": [
    ["@babel/preset-env", 
      "targets": 
        "browsers": ["last 1 Chrome versions"]
      
    ]
  ]

再次编译,结果如下:

$ npx babel babel.test.js
‘use strict‘;

const alertMe = msg => 
  window.alert(msg);
;
class Robot 
  constructor(msg) 
    this.message = msg;
  
  say() 
    alertMe(this.message);
  

const marvin = new Robot(‘hello babel‘);

最新版本的 Chrome 已经支持箭头函数、classconst,所以 babel 在编译过程中,不会编译它们。这也是为什么我们把 @babel/preset-env 称为 JavaScript 的 Autoprefixer。

babel-polyfill

Babel includes a polyfill that includes a custom regenerator runtime and core-js.

基本上,babel-polyfill 就是 regenerator runtime 加 core-js

可是,为什么需要 polyfill 这所谓的垫片?前面聊到 @babel/preset-env 时,不是说只要定义好我想支持的目标浏览器,babel 就能编译出能运行在目标浏览器上的代码吗?

我们暂时去掉 babel-,从 polyfill 说起。

拿 findIndex 来说,IE 11 仍不支持该方法,假如你的代码里写了 findIndex,IE 11 浏览器会报如下错误:

Object doesn‘t support property or method ‘findIndex‘

怎么办,这时我们就可以写个 polyfill

// https://tc39.github.io/ecma262/#sec-array.prototype.findIndex
if (!Array.prototype.findIndex) 
  Object.defineProperty(Array.prototype, ‘findIndex‘, 
    value: function(predicate) 
     // 1. Let O be ? ToObject(this value).
      if (this == null) 
        throw new TypeError(‘"this" is null or not defined‘);
      

      var o = Object(this);

      // 2. Let len be ? ToLength(? Get(O, "length")).
      var len = o.length >>> 0;

      // 3. If IsCallable(predicate) is false, throw a TypeError exception.
      if (typeof predicate !== ‘function‘) 
        throw new TypeError(‘predicate must be a function‘);
      

      // 4. If thisArg was supplied, let T be thisArg; else let T be undefined.
      var thisArg = arguments[1];

      // 5. Let k be 0.
      var k = 0;

      // 6. Repeat, while k < len
      while (k < len) 
        // a. Let Pk be ! ToString(k).
        // b. Let kValue be ? Get(O, Pk).
        // c. Let testResult be ToBoolean(? Call(predicate, T, « kValue, k, O »)).
        // d. If testResult is true, return k.
        var kValue = o[k];
        if (predicate.call(thisArg, kValue, k, o)) 
          return k;
        
        // e. Increase k by 1.
        k++;
      

      // 7. Return -1.
      return -1;
    
  );

如果目标环境中已经存在 findIndex,我们什么都不做,如果没有,我们就在 Array 的原型中定义一个。这便是 polyfill 的意义。babel-polyfill 同理。

虽说浏览器的特性支持状况千差万别,但其实可以提炼出两类:

  1. 大家都有,只是 A 语法与 B 语法的区别;
  2. 不是大家都有:有的有,有的没有。

babel 编译过程处理第一种情况 - 统一语法的形态,通常是高版本语法编译成低版本的,比如 ES6 语法编译成 ES5 或 ES3。而 babel-polyfill 处理第二种情况 - 让目标浏览器支持所有特性,不管它是全局的,还是原型的,或是其它。这样,通过 babel-polyfill,不同浏览器在特性支持上就站到同一起跑线。

下面我们看看 babel-polyfill 的用法。

安装 babel-polyfill

$ npm install --save @babel/polyfill

使用 babel-polyfill

我们需要在程序入口文件的顶部引用 @babel-polyfill

require(‘@babel/polyfill‘)
[].findIndex(‘babel‘)

或者使用 ES6 的写法:

import ‘@babel/polyfill‘
[].findIndex(‘babel‘)

需要注意的是,babel-polyfill 不能多次引用。如果我们的代码中有多个 require(‘@babel/polyfill‘),则执行时会报告错误:

only one instance of @babel/polyfill is allowed

这是因为引入的 babel-polyfill 会在全局写入一个 _babelPolyfill 变量。第二次引入时,会检测该变量是否已存在,如果已存在,则抛出错误。

注意事项

如前面所说的,babel-polyfill 其实包含 regenerator runtimecore-js,如果你的代码只需要其中一部分 polyfill,那么你可以考虑直接引入 core-js 下的特定 polyfill,不必使用 babel-polyfill 这样的庞然大物。

babel-runtime

babel-runtime 是 babel 生态里最让人困惑的一个包。

我们先来看看它的 package.json 里的 description 怎么写:

babel selfContained runtime

有点不知所谓。

不过从 package.json 里没有 main 字段我们可以看出,它的用法肯定不是 require(‘babel-runtime‘) 这样。

我们再看包依赖:

"dependencies": 
    "core-js": "^2.5.3",
    "regenerator-runtime": "^0.11.1"

跟 babel-polyfill 的包依赖 一模一样。

这正是让人疑惑不解的地方,为什么要有两个不同名称却相同依赖的包?它们的目的是否一样,是否能够共用?

我们拿 Object.assign 为例,剖析下 babel-polyfill 与 babel-runtime 的异同。

我们知道,IE 11 不支持 Object.assign,此时,我们有俩种候选方案:

  1. 引入 babel-polyfill,这样 Object.assign 就会被创造出来
  2. 配置 @babel/plugin-transform-object-assign

第二种方案中,babel 会将所有的 Object.assign 替换成 _extends 这样一个辅助函数。如下所示:

Object.assign(, )

编译成:

function _extends()  _extends = Object.assign || function (target)  for (var i = 1; i < arguments.length; i++)  var source = arguments[i]; for (var key in source)  if (Object.prototype.hasOwnProperty.call(source, key))  target[key] = source[key];    return target; ; return _extends.apply(this, arguments); 

_extends(, );

问题是,如果你的项目里有 100 个文件,其中有 50 个文件里写了 Object.assign,那么,坏消息来了,_extends 辅助函数会出现 50 次。

怎么办?我们自然而然会想到把 _extends 分离出去,然后在每个文件中引入 - 这正是 babel-runtime 的作用:

var _extends = require("@babel/runtime/helpers/extends");

_extends(, );

非常漂亮。可没人想要手动转换这些代码。

babel 提供了 @babel/plugin-transform-runtime 来做这些转换。

@babel/plugin-transform-runtime

我们首先安装插件:

$ npm install --save-dev @babel/plugin-transform-runtime

然后再安装 babel-runtime

$ npm install @babel/runtime

最后在 .babelrc 中配置:


  "plugins": [
    "@babel/plugin-transform-object-assign",
    "@babel/plugin-transform-runtime"
  ]

这样,我们不需要 babel-polyfill 也一样可以在程序中使用 Object.assign,编译后的代码最终能够正常运行在 IE 11 下。

提问:在经过 @babel/plugin-transform-runtime 的处理后,IE 11 下现在有 Object.assign吗?

答案是,仍然没有。

这正是 babel-polyfill 与 babel-runtime 的一大区别,前者改造目标浏览器,让你的浏览器拥有本来不支持的特性;后者改造你的代码,让你的代码能在所有目标浏览器上运行,但不改造浏览器。

如果你还是困惑,我推荐一个非常简单的区分方法 - 打开浏览器开发者工具,在 console 里执行代码:

  1. 引入 babel-polyfill 后的 IE 11,你可以在 console 下执行 Object.assign(, )
  2. 而引入 babel-runtime 后的 IE 11,仍然提示你:Object doesn‘t support property or method ‘assign‘

再回到我们前面提出的一个问题:babel-polyfill 是否可以跟 babel-runtime 共用?

这个问题,且留给读者们自己探索。

babel-register

经过 babel 的编译后,我们的源代码与运行在生产下的代码是不一样的。

babel-register 则提供了动态编译。换句话说,我们的源代码能够真正运行在生产环境下,不需要 babel 编译这一环节。

我们先在项目下安装 babel-register

$ npm install --save-dev @babel/register

然后在入口文件中 require

require(‘@babel/register‘)
require(‘./app‘)

在入口文件头部引入 @babel/register 后,我们的 app 文件中即可使用任意 es2015 的特性。

当然,坏处是动态编译,导致程序在速度、性能上有所损耗。

babel-node

我们上面说,babel-register 提供动态编译,能够让我们的源代码真正运行在生产环境下 - 但其实不然,我们仍需要做部分调整,比如新增一个入口文件,并在该文件中 require(‘@babel/register‘)。而 babel-node 能真正做到一行源代码都不需要调整:

$ babel-node app.js

只是,请不要在生产环境中使用 babel-node,因为它是动态编译源代码,应用启动速度非常慢。

babel入门教程(代码片段)

Babel是一个广泛使用的转码器,可以将ES6代码转为ES5代码,从而在现有环境执行。这意味着,你可以现在就用ES6编写程序,而不用担心现有环境是否支持。下面是一个例子。//转码前input.map(item=>item+1);//转码后input.map(function(item)... 查看详情

vue教程(三十一)webpack-es6转es5处理(代码片段)

Vue教程(三十一)webpack-ES6转ES5处理如果你仔细阅读webpack打包的s文件,发现写的ES6语法并没有转成ES5,那么就意味着可能一些对ES6还不支持的浏览器没有办法很好的运行我们的代码。将ES6的语法转成ES5,那么就需要使用babel的loader在webp... 查看详情

转babel那些事儿(代码片段)

本篇介绍babel的概念和用法。从前,一提到新东西,我的反应就是兼容性好不好,如果不能满足产品经理的需求,就还是用保守的方式实现吧。毕竟前端开发是一件很灵活的事,怎么写都行,至于为何会用某种方法,一定是综合... 查看详情

[转]babel-present-env与babel-polyfill学习总结(代码片段)

babelrc配置文件"presets":[["env","modules":false,"useBuiltIns":true,"targets":"browsers":["last2versions","safari>=7","ie>=9"]],"stage-0","react"],"plugins":["syntax-dynamic-import",["import", 查看详情

babel配置文件.babelrc(代码片段)

Babel是一个广泛应用的转码器,可以将ES6代码转为ES5代码,从而在现有环境执行。意味着可以使用ES6编写程序,而不用担心现有环境是否支持。Babel的配置文件是.babelrc,存放在项目的根目录下。使用Babel的第一步,就是配置这个... 查看详情

react项目实践——babel(代码片段)

1.babelBabel是一个广泛使用的转码器,可以将ES6代码转为ES5代码,从而在现有环境执行。(1)安装npminstall--save-devbabel-corebabel-eslintbabel-loaderbabel-polyfill babel-core:如果某些代码需要调用Babel的API进行转码,就要使用babel-core模块... 查看详情

babel学习(代码片段)

.babelrc文件babel可以将ES6编写的代码转码成你所需要的编码格式。前提是要指定希望的转码方式,即指定要用的插件并安装(否则babel什么也不做,输出源码)。可以在.balbelrc中进行指定:"presets":["es201... 查看详情

babel转码器(代码片段)

...Babel(babeljs.io/)是一个广为使用的ES6转码器,可以将ES6代码转为ES5代码,从而在浏览器或其他环境执行。  请看下面例子://转码前input.map(item=>item+1)//转码后input.map(function(item)returnitem+1) 配置文件.babelrcBabel的配置文... 查看详情

babel插件开发入门指南(代码片段)

文章概览主要包括:Babel如何进行转码、插件编写的入门基础、实例讲解如何编写插件。阅读本文前,需要读者对Babel插件如何使用、配置有一定了解,可以参考笔者之前的文章。本文所有例子可以在笔者的github找到,欢迎访问... 查看详情

快速写一个babel插件(代码片段)

...目前chrome应该是支持率最高的,所以为了兼容我们只能把代码转成es5,这应该算是我们最初使用babel的一个缘由,随着业务的开发,我们会有很多自己定制化的需求,单纯的bebel并不能解决我们所有的问题,所以babel插件应用而来... 查看详情

babel入门教程

1.安装es-checkernpm-ginstalles-checker2.执行es-checkeres-checker3.安装一个全局的babel-cli工具,用于命令行转码。npm-ginstallbabel-cli$npminstall--globalbabel-cli4.在工作根目录创建一个名字为.babelrc的文件,用来设置转码规则和插件{"presets":[//设定转码... 查看详情

下载babel(代码片段)

...件",用来接收e6"转码"后的内容命令:babele6-de55-执行e5的代码命令:node.XXX.js 查看详情

babel的使用,和安装配置(代码片段)

简介babel是一个广泛使用的转码器,可以将ES6代码转化为ES5代码,从而在现有环境执行,这意味着,你可以现在就用ES6编写程序,而不用担心现有环境是否支持。 安装及配置npminstall babel-cli--save-dev或者cnpminstall babel-cli... 查看详情

babel及其工作原理(代码片段)

...是BabelBabel是一个工具链,主要用于将ECMAScript2015+版本的代码转换为向后兼容的JavaScript语法,以便能够运行在当前和旧版本的浏览器或其它环境中。//Babel输入:ES2015箭头函数[1,2,3].map((n)=>n+1)//Babel输出:ES5语法实现的同等功能[1... 查看详情

webpack处理javascript兼容性--babel(代码片段)

.package允许你使用Babel和webpack转译JavaScript文件。因为javaScript的版本一直都在更新迭代,所以需要转译为浏览器可认识的文件内容,经常来说,我们会将ES6转换成ES5。一、Babel初使用1.基本兼容性处理1.1安装包 npminstallba... 查看详情

为什么要用babel-polyfill(代码片段)

...npminstallbabel-polyfill-S因为是一个polyfill(它需要在你的源代码之前运行),我们需要让它成为一个dependency,而不是一个devDependency 3.在Node/Browserify/Webpack中使用你需要在你的应用入口顶部通过require将polyfill引入进来。确保它在... 查看详情

复习babel(代码片段)

...时转码,所以只适合在开发环境使用babel-core:如果某些代码需要调用Babe 查看详情

ast入门(代码片段)

拓展JavaScript教程ES6入门教程百度在线字体编辑器奇Q在线字体编辑器fonttoolsAST在线解析网站babel库GitHubbabel库docsBabel插件开发手册查看JavaScript代码流程GitHub地址安装nodehttps://nodejs.org/zh-cn/babelnpminstall@babel/core基本框架constfs=require(‘... 查看详情