@babel/polyfill的踩坑之路

在网页需要向低版本兼容时,如IE不支持promise等新特性,我们仅仅使用babel进行es5转换是不够的,还需要把这些新特性进行转换

polyfill介绍

有些人不理解@babel/polyfill到底做了什么,以为运行了命令行工具也会将新的api转换成原有代码,事实上只是引入了大量的polyfill而已
浏览器环境下使用@babel/standalone动态的将ES6转换成ES5,针对IE11,模块引用了Object.assign这个新的api,因此需要使用@babel/polyfill。当然,自己写一个polyfill实现也是可以的。

polyfill作用

Babel 包含一个polyfill 库。这个库里包含 regenerator 和 core-js.

这个库将会模拟一个完全的 ES2015+ 的环境。

这意味着你可以使用 新的内置语法 比如 promise 或者 WeakMap, 静态方法比如Array.from 或 Object.assign, 实例方法 比如 Array.prototype.includes 和 generator 函数。

使用步骤

1. 安装必备配置

​ 1.1 初始化项目
npm init -y

​ 2.2 安装babel和webpack
​ npm install babel-loader@8 @babel/core@7 @babel/preset-env webpack3 ​

注意:这里版本要一致。webpack 3.x | babel-loader 8.x | babel 7.x

2. 安装polyfill

npm install --save @babel/polyfill
​ 这个是在你的source code前运行的,所以安装的时候是 –save

3 导入polyfill
polyfill 用起来很方便,但是你应该和 @babel/preset-env 以及 useBuiltIns 的option 一起用。如果不这样做的 话,我们建议你手动引入需要的每个polyfill

​ 确保 它在 其他代码或者 引用前被调用

使用CommonJS导入

require('@babel/polyfill')

或者使用ES6导入**
import '@babel/polyfill'

4. 选择使用方式

webpack 集成polyfill

和babel配置文件一起用的时候

如果在.babelrc中指定 useBuiltIns: ‘usage’的话

那么就不要在webpack.config.js 的 entry array 和source 中包含 @babel/polyfill 了。注意,@babel/polyfill 依然需要安装

如果在.babelrc 中指定 useBuiltIns: ‘entry’的话

那么就要和上面讨论的一样,在你应用的入口文件顶部通过require 或者 import 引入@babel/polyfill

如果在.babelrc 中没有指定useBuiltIns的值或者useBuiltIns: false

可以直接在webpack.config.js 的 entry array 中添加 @babel/polyfill

module.exports = {
	entry: ['@babel/polyfill','./src/main.js']
}

如果没有使用babel配置文件.那么就可以像我们上面讨论的一样把@babel/polyfill 添加到webpack 的entry array 中。你也可以直接通过import 或require 把它添加到应用的入口文件顶部。但是我们并不推荐这么做

babel配置文件中.babelrc和babel.config.js的区别

当我们需要用到node_modules进行编译时,建议用babel.config.js文件来配置

(文中我们使用的是webpack,需要用到node_modules,所以使用babel.config.js配置babel)

当我们只需要配置编译js不需要其他操作时,可以用.babelrc

babel的文件配置

这里只兼容到IE11,如需要添加其他配置可自行添加

module.exports = function (api) {
  api.cache(true);

  const presets = [
      ["@babel/preset-env", {
        "targets": {
          "chrome": "70",
          "ie": "11"
        },
        "useBuiltIns": false
      }]
  ];

  return {
    presets
  };
}

webpack文件配置

由于转义时会把所有引用的js一起转义,而node_modules不需要转义,所以这里使用exclude进行排除处理

const path = require('path');

module.exports = {
  entry: ['@babel/polyfill','./src/main.js'],
  output: {
    path: path.resolve(__dirname, 'dist'),
    filename: 'bundle.js'
  },
  module: {
    rules: [
      {
        test: /.js$/,
        exclude: /(node_modules|bower_components)/,
        use: {
          loader: 'babel-loader',
          options: {
            presets: ['@babel/preset-env'],
            plugins:[
              "@babel/plugin-transform-runtime",
              "@babel/plugin-proposal-object-rest-spread"
            ]
          }
        }
      }
     ]
   }
};

扩展:细心的小伙伴可能注意到,我的babel配置中还增加了两个插件plugins,如不需要删除配置文件即可。

plugin-transform-runtime可重新使用Babel注入的帮助程序代码以节省代码大小,也可转义迭代器。

安装:

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

npm install --save @babel/runtime

配置如上

plugin-proposal-object-rest-spread使用Babel的objectSpread程序生成符合规范的代码,也可转义数组解构。

安装:

npm install --save-dev @babel/plugin-proposal-object-rest-spread

配置如上

注意事项

babel只会转换E6语法,而不会转换新的api,让新的api生效的方法是使用传统的polyfill,为此需要引入这个模块

安装的时候必须用 –save 保证引用到生产环境而不是开发环境,当然,弄错了,自己手动在package.json中修改也是可以的。

如果只是测试下浏览器环境使用,用script标签引用模块下的polyfill.min.js文件,即可实现polyfill的导入,方法如下,但实际使用不建议!

<!-- 引入polyfill 让es6新的api能够在ie11上使用 这其实和babel没什么关系 -->
	<script type="text/javascript" src="./polyfill.min.js"></script>
<!-- 引用@babel/standalone 这个是babel在浏览器上使用的模块 会把ES6转成ES5 但是它依赖ES6的新api -->
	<script type="text/javascript" src="https://unpkg.com/@babel/standalone/babel.min.js"></script>