webpack+babel项目在IE下报Promise未定义错误引出的思考

低版本浏览器引起的问题

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

很明显,项目中使用了 Promise ,但是IE9又不支持该新特性,所以导致报错。

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

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

按照 babel官网 的介绍, babel-runtimebabel-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()

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

可以看到,在项目中, 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的官网也找到了 答案

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

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

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

// 将Promise抛出为全局对象
window.Promise = Promise

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

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

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

在跨浏览器中的选择

本人的大部分后台项目,一般会要求使用人员使用chrome浏览器,只选择 babel-runtime 就可以满足需求,因为chrome大部分js新特性都支持,如字符串实例的 includes , 虽然babel-runtime不会编译,但是浏览器自己会支持,不会产生问题。但是对于跨浏览器的项目就需要特别考虑了。

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

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

参考文献

1、 webpack文档

2、 babel的polyfill和runtime的区别

3、 babel原理和polyfill和runtime的区别

4、 webpack+babel+transform-runtime, IE下提示Promise未定义?

博客园-原创精华区稿源:博客园-原创精华区 (源链) | 关于 | 阅读提示

本站遵循[CC BY-NC-SA 4.0]。如您有版权、意见投诉等问题,请通过eMail联系我们处理。
酷辣虫 » 前端开发 » webpack+babel项目在IE下报Promise未定义错误引出的思考

喜欢 (0)or分享给?

专业 x 专注 x 聚合 x 分享 CC BY-NC-SA 4.0

使用声明 | 英豪名录