webpack+vue项目在IE下报Promise未定义错误的踩坑

低版本浏览器引起的问题

一个基于webpack+babel+vue的项目，一般本地是在chrome浏览上面开发，chrome浏览器开发因为支持大部分新的js特性，所以一般不怎么需要polyfill， 比如Promise，string实例的includes方法等。即使在低版本浏览器中，通过babel-runtime的polyfill也是可以转换的，但是事不竟然，项目在IE9浏览器上报错，错误如下截图：

image.png

很明显，项目中使用了Promise，在请求数据的时候也是使用Promise来封装的ajax方法的，请求数据就可以的，在我们进行项目优化的时候，我们进行了对项目按需加载模块来打包，现在导致了IE9又不支持该新特性，所以导致报错。

那么， 问题来了，babel-runtime不是会自动polyfill项目中的Promise功能么，为啥没有呢？下面就来一探究竟。

babel-runtime真的帮我们转换了么

按照babel官网的介绍，babel-runtime跟babel-polyfill一样，都是对不支持的新功能进行polyfill，只是：

• babel-runtime: 他不会污染全局环境，会在局部进行polyfill，另外不会转换一些实例方法，如'abc'.includes('a')，其中的includes方法就不会翻译。它一般结合babel-plugin-transform-runtime来使用。

• babel-polyfill：简单粗暴，他会污染全局环境，比如在不支持Promise的浏览器会polyfill一个全局的Promise对象供调用；另外，不支持的实例方法也在对应的构造函数原型链上添加要polyfill的方法。

那么上面例子中的Promise，babel-runtime真的帮我们转换了么，在项目中测试一下，发下它确实转换了。

  let _promise = new Promise()

如上，在代码中测试一下，查看对应的转换文件：

image

可以看到，在项目中，babel-runtime真的帮我们进行了polyfill，那为啥还会报上面的Promise未定义的错误呢？？？

Promise未定义错误真凶

既然babel-runtime会对经过babel编译的代码进行代码转换，那么可以猜想：

错误的真正原因是一些代码没有经过babel-runtime编译转换。

首先想到的是node_modules模块，因为一些npm包在webpack配置中不需要babel的编译，而这些包可能需要Promise的原生支持功能.

如vuex，之前就有人在github上提出过类似的问题vuex requires a promise polyfill in this browser。因为在它源码里面是这样判断的：

assert(typeof Promise !== 'undefined', "vuex requires a Promise polyfill in this browser.");

这样的情况需要主要，经过排查，在本项目中，没有发现是因为npm包引起的。那么还有一种可能：webapck本身产生的一些代码。

通过定位错误发生地方，发现确实是webpack自身产生的代码需要Promise。在webpack的官网也找到了答案：

image

可以发现，在webpack使用异步加载模块时， require.ensure需要原生支持Promise，因为我们项目是按需加载，所以才导致上面问题的产生。即：

webpack生成的new Promise相关代码, 超出babel的babel-runtime的控制范围，只有polyfill全局的Promise才能解决此问题。

解决上面的问题， 大部分人会想到使用其他Promise的polyfill库，如babel-polyfill或者es6-promise等，这固然是一个解决办法，但是可以结合babel-runtime的转换功能来为全局Promise进行polyfill，不会引入额外的库。代码如下：

在vue项目的main.js文件加上这句话
// 将Promise抛出为全局对象
window.Promise = Promise

image.png

然后babel-runtime会将其转化为如下：

// 将Promise抛出为全局对象
window.Promise = __WEBPACK_IMPORTED_MODULE_0_babel_runtime_core_js_promise___default.a()

这样，将babel-runtime的Promise的polyfill挂到window下，达到其他Promise的polyfill的效果。

在跨浏览器中的选择

• 对于跨浏览器的项目，尤其是低版本的IE时，建议选择babel-polyfill, 它可以对静态或者实例方法都会转换

• 对于指定的浏览器的项目如chrome，直接使用babel-runtime来进行转换，它不会对实例方法进行转换。