Vue 兼容 ie9 的全面解決方案

前言

背景狀況

• vue - 2.5.11
• vue-cli 使用模板 webpack-simple
• http請求：axios

Vue 官方對於 ie 瀏覽器版本兼容狀況的描述是 ie9+，便是 ie9 及更高的版本。通過測試，Vue 的核心框架 vuejs 自己，以及生態的官方核心插件（VueRouter、Vuex等）都可以在 ie9 上正常使用。

Vue 的做者尤雨溪對於 Vue 的學習建議 中有說起爲了將項目更好的生態化/工程化，要儘量學習及使用新的 ECMAScript 規範。目前 ES6/ES2015 是可用度和穩定度較高的規範，文檔齊全，國內還有 阮一峯 《ECMAScript 6 入門》 作了大量的文檔翻譯，開發環境可謂完善。然而版本較舊的瀏覽器並不支持 es6 規範，尤爲是 ie 瀏覽器，即便是最高的 ie11 版本，對於 es6 規範也支持得並不全。如此則須要對全部原生不支持 ES6 特性的瀏覽器作兼容性處理。

本文將針對使用 Vue 生態開發完成的網站，以 ie9 版本爲基礎兼容目標，實現全功能正常使用的全面兼容解決方案。

ES6兼容

在 ie9 的環境上，es6 的部分新對象、表達式，並不支持，解決方案是使用 babel-polyfill 組件，它能夠將 es6 的代碼翻譯成低版本瀏覽器能夠識別的 es5 代碼

npm i babel-polyfill --save-dev

安裝完成後，在項目的主入口文件 main.js 的首行就能夠直接引用

import 'babel-polyfill';

在項目使用 vue-cli 生成的代碼中，根目錄有一個 .babelrc 文件，這是項目使用 babel 的配置文件。在默認生成的模板內容中，增長 "useBuiltIns": "entry" 的設置內容，這是一個指定哪些內容須要被 polyfill(兼容) 的設置

useBuiltIns 有三個設置選項

• false - 不作任何操做
• entry - 根據瀏覽器版本的支持，將 polyfill 需求拆分引入，僅引入有瀏覽器不支持的polyfill
• usage - 檢測代碼中 ES6/7/8 等的使用狀況，僅僅加載代碼中用到的 polyfill

這裏推薦設置爲 entry ，完整的 .babelrc 內容以下：

{
  "presets": [
    [
      "env",
      {
        "modules": false,
        "useBuiltIns": "entry"
      }
    ],
    "stage-3"
  ]
}

加入這些代碼後，工程裏的大部份內容已可兼容到 ie9 版本

Number對象

即便在使用 babel-polyfill 作代碼翻譯後，發現仍是有一些 es6 的新特性並無解決，好比說 Number 對象的 parseInt 和 parseFloat 方法

es6 將全局方法 parseInt() 和 parseFloat() ，移植到 Number 對象上面，行爲徹底保持不變。這樣作的目的，是逐步減小全局性方法，使得語言逐步模塊化。

解決這個問題不須要引入包來解決，一樣在項目主入口文件 main.js 加入如下代碼（代碼儘量靠前，最好是在引用 babel-polyfill 以後 ）

if (Number.parseInt === undefined) Number.parseInt = window.parseInt;
if (Number.parseFloat === undefined) Number.parseFloat = window.parseFloat;

requestAnimationFrame方法

window.requestAnimationFrame 是瀏覽器用於定時循環操做的一個接口，相似於 setTimeout，主要用途是按幀對網頁進行重繪。

requestAnimationFrame 的優點，在於充分利用顯示器的刷新機制，比較節省系統資源。顯示器有固定的刷新頻率（60Hz或75Hz），也就是說，每秒最多隻能重繪60次或75次，requestAnimationFrame 的基本思想就是與這個刷新頻率保持同步，利用這個刷新頻率進行頁面重繪。此外，使用這個API，一旦頁面不處於瀏覽器的當前標籤，就會自動中止刷新。這就節省了CPU、GPU和電力。

不過有一點須要注意，requestAnimationFrame 是在主線程上完成。這意味着，若是主線程很是繁忙，requestAnimationFrame 的動畫效果會大打折扣。

window.requestAnimationFrame() 方法告訴瀏覽器您但願執行動畫並請求瀏覽器在下一次重繪以前調用指定的函數來更新動畫。該方法使用一個回調函數做爲參數，這個回調函數會在瀏覽器重繪以前調用。

有部分第三方組件就使用了這個方法，例如部分文件上傳、圖片處理類的組件；那麼在這類型的組件在 ie9 下使用時，會報出

SCRIPT5007: Expected object.

window.requestAnimationFrame() 的最低兼容 ie 版本爲 10，那麼在 ie9 上作兼容就須要製做 requestAnimationFrame polyfill

(function() {
    var lastTime = 0;
    var vendors = ['ms', 'moz', 'webkit', 'o'];
    for(var x = 0; x < vendors.length && !window.requestAnimationFrame; ++x) {
        window.requestAnimationFrame = window[vendors[x]+'RequestAnimationFrame'];
        window.cancelAnimationFrame = window[vendors[x]+'CancelAnimationFrame'] 
                                   || window[vendors[x]+'CancelRequestAnimationFrame'];
    }
 
    if (!window.requestAnimationFrame)
        window.requestAnimationFrame = function(callback, element) {
            var currTime = new Date().getTime();
            var timeToCall = Math.max(0, 16 - (currTime - lastTime));
            var id = window.setTimeout(function() { callback(currTime + timeToCall); }, 
              timeToCall);
            lastTime = currTime + timeToCall;
            return id;
        };
 
    if (!window.cancelAnimationFrame)
        window.cancelAnimationFrame = function(id) {
            clearTimeout(id);
        };
}());

Gist：requestAnimationFrame polyfill

這部分代碼一樣是儘量在網站入口處就執行

http網絡請求(跨域)

在大多數的 Web 項目中（以 JavaWeb 爲例），網站的頁面和服務（至少是 controller 層）在同一個工程進行開發和部署，在大前端的新型模式下，咱們建議儘量對網站的前端和後端進行徹底分離，先後端分離的好處和意義這裏再也不贅述。

既然是先後端分離，那麼部署也必然是各自獨立部署，不一樣的訪問路徑，就會產生跨域訪問的問題（同一站點，不一樣端口號也是跨域）

在此設定背景狀況：

• 服務端已完整開啓 CROS 跨域支持
• http 組件使用 axios
• axios 設置 withCredentials 爲 true 開啓跨域訪問時攜帶 cookie 數據

高版本瀏覽器（ie10+ 或 chrome, ff）僅須要完成背景狀況中的功能，便可支持跨域數據請求功能

axios 進行數據請求時，默認使用 XMLHttpRequest 對象，在檢測到當前請求是跨域訪問時，axios 會測試瀏覽器是否支持 XDomainRequest 對象，若支持則優先使用。

ie8 / ie9 的 XMLHttpRequest 對象，不支持跨域訪問，該對象在 ie10 後才原生支持跨域訪問。微軟的解決方案是在 ie8 / ie9 中提供了 XDomainRequest(XDR) 對象來進行解決跨域問題，雖然使用該對象能夠跨域訪問成功，並返回數據，但它卻依然是一個功能不完整的半成品，它的使用有諸多限制：

• XDR 僅支持 GET 與 POST 兩種請求方式
• XDR 不支持自定義的請求頭，若服務端使用 header 的自定義參數進行作身份驗證，則不可用
• 請求頭的 Content-Type 只容許設置爲 text/plain
• XDR 不容許跨協議的請求，若是網頁在 HTTP 協議下，就只能請求 HTTP 協議下的接口，不能訪問 HTTPS 接口
• XDR 只接受HTTP/HTTPS 的請求
• 發起請求的時候，不會攜帶 authentication 或 cookies

微軟雖然提供瞭解決方案，但倒是徹徹底底的雞肋，根本沒法勝任系統中各類場景的數據請求需求，至此，axios 對 ie9 的跨域數據請求已無能爲力。

完美解決方案：代理(proxy)

雖然 axios 對 ie9 跨域已無能爲力，但前端項目打包的解決方案 webpack 提供了一個優雅而完全解決問題的方式：代理

devServer.proxy

webpack 的 devServer.proxy 的功能是由 http-proxy-middleware 項目來實現的

實現原理是將目標位置的請求代理爲前端服務本地的請求，既然是代理成爲本地的請求，就不存在跨域的問題，axios 就會用回 XMLHttpRequest 對象進行數據請求，一切都恢復正常了，header、cookies、content-type、authentication 等內容都被正確傳遞到服務端。

項目中 webpack.config.js 的配置

devServer: {
    historyApiFallback: true,
    noInfo: true,
    overlay: true,
    proxy: {
        '/api': {
            target: 'http://localhost:8081/myserver',
            pathRewrite: {
                '^/api': ''
            }
        }
    }
}

配置中指定了將 http://localhost:8081/myserver 服務的位置代理爲本地前端服務的 http://localhost:8080/api。例如須要讀取用戶信息的原請求是 http://localhost:8081/myserver/user/zhangsan，代理後，就變爲 http://localhost:8080/api/user/zhangsan。

便是 /api 的前綴表明了服務端，因此在使用 axios 時，須要對每一個服務端請求都增長上 /api 的前綴；一般在項目開發中，須要對數據請求組件 axios 進行二次封裝，以達到統一設置默認參數，統一數據請求入口等目的，那麼此時就只須要在二次封裝的文件裏統一調整請求前綴便可。

不過，webpack 的 devServer.proxy 僅在開發模式下可用，生產模式下沒法使用。開發模式下，調試服務能夠讀取 webpack.config.js 中的配置內容進行實時代理，而項目在部署到生產環境前，須要將工程進行編譯轉換成靜態的 js 文件，沒有調試服務的支撐天然是沒法進行請求代理的。

nginx 配置

雖然 devServer.proxy 的功能僅能工做於開發模式，那麼在生產模式下，天然也是有解決方案的；一般 Vue 的項目在編譯成最終的 js 文件後，僅須要靜態服務器便可，這其中又以 nginx 爲最優選擇方案，輕量、高性能、高併發、反向代理服務等均爲其優勢，這裏須要作的數據請求代理的功能就使用到了 nginx 的 反向代理 功能

conf/nginx.conf 文件配置增長如下內容

location /api/ {
    proxy_pass http://localhost:8081/myserver/;
}

該配置一樣是將 http://localhost:8081/myserver/ 的目標服務端位置代理爲本地服務的 /api 路徑，如此，生產環境下的數據請求問題也得以解決

我的原創內容，轉載請說明出處

完整內容：https://github.com/TerryZ