Webpack-IE低版本兼容指南


來源:https://github.com/zuojj/fedlab/issues/5

Webpack,Webpack 是一個前端資源加載/打包工具,現在版本已經 release 到 v2.6.1,今天的文章不直接介紹Webpack的API及使用,而是對最近項目開發中使用Webpack打包時處理IE低版本(IE8及以下)瀏覽器兼容問題做一次總結。

PC端項目前端基礎技術選型jQuery + ES6 + EJS + Babel + Webpack:

  • jQuery:提供選擇器和ajax接口兼容支持;
  • ES6:跟進前端趨勢,方便向后兼容;
  • EJS:提供前端模板引擎支持;
  • Babel:提供 ES6 轉碼支持;
  • Webpack: 提高前端資源加載/打包;

項目開發過程都在 Chrome 瀏覽器中,一切都OK,沒有任何問題,當在IE9以下瀏覽器中調試發現好多坑,現總結如下,以后新手參考。

Case One: default 、 classcatch ES3中保留字問題

報錯信息:

SCRIPT1048: 缺少標識符

對應代碼:

e.n = function (t) { var n = t && t.__esModule ? function () { return t.default } : function () { return t }; return e.d(n, "a", n), n }

網上查找資料,webpack有一款loader插件es3ify-loader來處理ES3的兼容問題,修改webpack配置,問題解決,添加規則如下:

module: {
    rules: [{ test: /.js$/, enforce: 'post', // post-loader處理 loader: 'es3ify-loader' } ] }

這個loader是干啥用的捏,就是把這些保留字給你加上引號,使用字符串的形式引用,請看實例:

// 編譯前 function(t) { return t.default; } // 編譯后 function(t) { return t["default"]; }

Case Two: uglify-js產生問題

重新構建,在IE低版本瀏覽器預覽,使用 webpack.optimize.UglifyJsPlugin 壓縮時,又報上面同樣的錯誤了,重新采用 beauty:true, build 發現引號被壓縮掉了,究其原因,研究了下uglify-js默認配置,發現了 compress.properties 屬性,增加build options如下,問題解決:

new webpack.optimize.UglifyJsPlugin({ compress: { properties: false, warnings: false }, output: { beautify: true }, sourceMap: false })

Case Three: uglify-js問題

重新構建,在IE低版本瀏覽器預覽,使用 webpack.optimize.UglifyJsPlugin 壓縮時,又報上面同樣的錯誤了,報錯代碼:

{
    catch: function (t) { return this.then(null, t) } }

繼續查找uglify-js配置,發現 output.quote_keys,修改build options,問題解決:

new webpack.optimize.UglifyJsPlugin({ compress: { properties: false, warnings: false }, output: { beautify: true, quote_keys: true }, sourceMap: false }),

編譯后:

{
    "catch": function(t) { return this.then(null, t); } }

Case Four: uglify-js問題

重新構建,在IE低版本瀏覽器預覽,報錯信息如下:

SCRIPT3126: 無法設置未定義或 null 引用的屬性

繼續分析壓縮后代碼,發現還是uglify-js問題,其mangle 配置屬性 mangle.screw_ie8 默認為 true, 什么意思捏,意思就是把支持IE8的代碼clear掉,screw you => 去你的,修改壓縮配置項,重新編譯,問題解決:

new webpack.optimize.UglifyJsPlugin({ compress: { properties: false, warnings: false }, output: { beautify: true, quote_keys: true }, mangle: { screw_ie8: false }, sourceMap: false })

Case Five: ES5的API兼容報錯

在 webpack 的 entry 入口文件top引入 es5-shim 問題解決

require('es5-shim'); require('es5-shim/es5-sham');

Case Six: Console.log 問題

在 webpack 的 entry 入口文件top引入 console-polyfill 問題解決

require('console-polyfill');

Case Seven: Promise 兼容

在 webpack 的 entry 入口文件top引入 es6-promise 問題解決

require('es6-promise');

Case Eight: Object.defineProperty 問題

這個case 應該說是最難搞的一個case了,耗時也比較長,關鍵點在於使用 es5-shim/es5-sham也有問題,查看你官網發現在低版本瀏覽器也會有問題,官網描述如下:

:warning: Object.defineProperty
In the worst of circumstances, IE 8 provides a version of this method that only works on DOM objects. This sham will not be installed. The given version of defineProperty will throw an exception if used on non-DOM objects.
In slightly better circumstances, this method will silently fail to set "writable", "enumerable", and "configurable" properties.
Providing a getter or setter with "get" or "set" on a descriptor will silently fail on engines that lack "defineGetter" and "defineSetter", which include all versions of IE.
https://github.com/es-shims/es5-shim/issues#issue/5

那這個Object.defineProperty 是如何產生的呢,這個是babel編譯后產生的,當我們在代碼使用 importexport ES6 Module時出現的,那你可能最直接的想法就是我不用ES6 Module了,改用Commonjs規范,OK,修改后編譯,確實解決了問題,但是查看代碼里還是有一段代碼的,如下:

e.d = function(t, n, r) { e.o(t, n) || Object.defineProperty(t, n, { "configurable": !1, "enumerable": !0, "get": r }); }, e.n = function(t) { var n = t && t.__esModule ? function() { return t["default"]; } : function() { return t; }; return e.d(n, "a", n), n; }, e.o = function(t, e) { return Object.prototype.hasOwnProperty.call(t, e); }

看代碼已經做了容錯判斷。

Case Nine: Object.defineProperty 問題

重新構建,加入 json3 處理 JSON 對象兼容時,代碼在此處拋出了異常:

var hasGetter = 'get' in descriptor; var hasSetter = 'set' in descriptor; if (!supportsAccessors && (hasGetter || hasSetter)) { throw new TypeError(ERR_ACCESSORS_NOT_SUPPORTED); }

分析supportsAccessors代碼邏輯:

var supportsAccessors = owns(prototypeOfObject, '__defineGetter__');

通過斷點調試,supportsAccessors值為false且hasGetter或者hasSetter時拋出了異常,也就是說當前js引擎不支持訪問器屬性,卻在屬性描述符中設置了get,set,那么就會拋出異常。查看 defineGetter 的兼容情況,只兼容IE11,雖然IE9、IE10同樣不支持defineGetter,不過他們直接支持Object.defineProperty方法和get語法,無需sham,所以代碼並不會走到異常這里。但是IE8以下就扯淡了。解決這種情況只能修改源代碼了。

至此,Webpack打包時,IE低版本瀏覽器(IE8及以下)遇到的兼容問題就總結這里,如果你有新的問題,歡迎留言。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM