Vue2中 引入使用 babel-polyfill 兼容低版本浏览器

注意：本文主要介绍的 vue-cli 版本：3.x， 4.x；

问题描述

最近在项目中使用 webpack 打包后升级，用户反馈使用浏览器（chrome 45）访问白屏。经过排查发现：由于 chrome 45 无法兼容 ES6 语法导致的，因此需要将项目中的 ES6 语法转 ES5 语法。

vue-cli3创建的项目，在低版本浏览器中运行，运行不起来，因为默认都是开启高版本浏览器。
控制台会报一系列错误，特别是node_modules中的插件的es6等高级语法不识别问题。所以按照下面的配置一步解决。

请注意

默认情况下，babel-loader会忽略所有 node_modules 中的文件，但是我们在某一些安装包引入的时候也需要进行babel转换，那怎么办呢
transpileDependencies：转换node-modules必备

1. 兼容低版本浏览器方法

1.1 安装 babel-polyfill

babel-polyfill npm地址

npm i babel-polyfill

1.2 引入

方式一（推荐）：main.js 顶部第一行

import 'babel-polyfill';

方式二：vue.config.js 中，在 chainWebpack 内添加以下代码

chainWebpack: config => {
  config.entry('main').add('babel-polyfill')
  config.entry.app = ['babel-polyfill', './src/main.js']
}

1.3（新增）在 babel.config.js 中配置

module.exports = {
  presets: [
    ['@vue/app', {
      polyfills: [
        'es6.promise',
        'es6.symbol',
        'es6.array.iterator',
        'es6.object.assign',
      ],
      useBuiltIns: 'entry',
    }],
  ],
}

【本人认证生效】1.4 在 vue.config.js （新增）配置 transpileDependencies

如果还引入了其他插件而该插件内部也存在ES6写法，则需要将这些插件的 ES6 转换成 ES5，使用 transpileDependencies 直接将需要转换的插件放入。

可以将整个node_modules匹配，但是打包的文件太大，可以单独将有问题的文件单独匹配即可。

  //部分
  transpileDependencies: [
    'element-ui', 'vant', 'js-cookie', 'vxe-table', 'xe-utils','vue-virtual-scroll-list','vue-socket.io'
  ],
  //or
 transpileDependencies: [
    	/[/\\]node_modules[/\\]sm-crypto[/\\]/,
    	/[/\\]node_modules[/\\]view-design[/\\]/,
        // /[/\\]node_modules[/\\]test[/\\]/, // 配置方式
        // /[/\\]node_modules[/\\][@\\]test2[/\\]test3[/\\]/,
    ]

// 全部
transpileDependencies: /[\\/]node_modules[\\/].+[\\/]/

vue-cli 官方文档中 transpileDependencies 说明

补充说明

• 如安装配置 babel-polyfill 后仍无法兼容低版本浏览器，可适当降级 babel-polyfill 的版本；
• 如使用 cnpm安装依赖，可能会导致transpiledependencies无效，具体原因还未深究。可直接将 node_modules全部删掉，重新使用 npm 安装所有依赖后，再次重新打包，目前问题已解决
• vue-cli 使用 wokrer-loader 加载 web woker 时，使用npm run build有很大机率会打包失败：（报错：Syntax Error: Thread Loader (Worker 4) The “from” argument must be of type string. Received undefined）。原因 ：thread-loader 与 worker-loader 有冲突。解决： vue.config.js 中配置 parallel: false 。构建正式环境关闭thread-loader。

vue-cli 2.x 中配置 babel 转换

@babel/core：babel 的核心库
必引，一切 babel 转换操作都基于 @babel/core，因为它包含了编译的 transform 方法

npm install --save-dev @babel/core

@babel/polyfill：用于模拟完整的 ES2015+ 环境
注意：–save 而非 --save-dev，因为这是需要在源码之前运行的 polyfill；

npm install --save @babel/polyfill

安装之后，在项目入口 main.js 引入 @babel/polyfill 即可；

babel-loader：webpack 配置 loader 转换
babel-loader 允许使用 Babel 和 webpack 来转译 JavaScript 文件

npm install --save-dev babel-loader

webpack.base.config.js 文件中配置

module.exports = {
  module: {
    rules: [
      {
        test: /\.js$/,
        loader: 'babel-loader',
        include: [resolve('src')]
      }
    ]
  }
}

通过以上配置即可达到在 vue-cli 2.x 中进行 babel 转换

拓展：关于 Babel 简介
Babel 中文官方文档

Babel 是一个工具链，主要用于将采用 ECMAScript 2015+ 语法编写的代码转换为向后兼容的 JavaScript 语法，以便能够运行在当前和旧版本的浏览器或其他环境中。下面列出的是 Babel 能为你做的事情：1. 语法转换；2. 通过 Polyfill 方式在目标环境中添加缺失的特性 （通过引入第三方 polyfill 模块，例如 core-js）；3. 源码转换（codemods）；

参考地址链接：https://blog.youkuaiyun.com/ZYS10000/article/details/129035504
https://blog.youkuaiyun.com/yw00yw/article/details/113136790