DIV CSS 佈局教程網

用 window.onerror 捕獲並上報 JS 錯誤:從 2048 的線上事故說起
編輯:關於JavaScript     

前幾天有個 2048 小遊戲的使用者回報:打開之後不能玩,只有一個遊戲面板,數字無法初始化,方塊也移不動,設備是 iPhone 4S、iOS 5.1。換從微信裡調起 Safari 一樣無效。由於遊戲裡用了不少 HTML5 特性,粗略判斷應該是 JS 報錯導致。問題是——這種錯誤該怎麼捕捉?

答案就是 window.onerror。

先看規格怎麼定義

W3C 對這個方法的說明如下:

換成程式碼就是:

 /**
 * @param {String} errorMessage  錯誤信息
 * @param {String} scriptURI     出錯的文件
 * @param {Long}   lineNumber    出錯代碼的行號
 * @param {Long}   columnNumber  出錯代碼的列號
 * @param {Object} errorObj      錯誤的詳細信息,型別不限
 */
window.onerror = function (errorMessage, scriptURI, lineNumber, columnNumber, errorObj) {
    // TODO
}; 

使用時要注意相容性:並非所有瀏覽器都提供後面那幾個參數。Chrome 這類通常走在標準草案前面,這些參數拿來用沒問題,但要為舊環境留退路。

寫個 Demo 試試

 <!DOCTYPE html>
<html>
<head>
<title>Js錯誤捕獲</title>
<script type="text/javascript">
window.onerror = function (errorMessage, scriptURI, lineNumber, columnNumber, errorObj) {
    console.log("錯誤信息:", errorMessage);
    console.log("出錯文件:", scriptURI);
    console.log("出錯行號:", lineNumber);
    console.log("出錯列號:", columnNumber);
    console.log("錯誤詳情:", errorObj);
}
</script>
</head>
<body>
<script type="text/javascript" src="error.js"></script>
</body>
</html>

error.js 裡只寫一行:

 throw new Error("出錯了!"); 

用瀏覽器跑起來、打開 console,會看到:

五項資訊都齊全,這些就是可以做上報的資料。

換成不同網域,情況就變了

上面的 error.js 與頁面同源。如果把它換到別的網域:

 <script type="text/javascript" src="//doitbegin.duapp.com/error.js"></script> 

再打開 console:

onerror 只捕到一個 errorMessage,而且是固定字串,毫無參考價值。查了資料(Webkit 原始碼)才確認:瀏覽器在實作 script 資源載入的地方做了同源策略判斷,非同源資源的 errorMessage 會被寫死成 Script error:

好在 script 標籤有 crossorigin 屬性,加上它就能拿到比較完整的訊息:

 <script type="text/javascript" src="//doitbegin.duapp.com/error.js" crossorigin></script> 

重新整理,console 出現:

這也在意料之中:既然宣告了 crossorigin,對方的 HTTP Response Header 也必須允許跨網域存取。為了方便設定 Header,把 error.js 改寫成一個 PHP 檔:

 <?php
header('Access-Control-Allow-Origin: *');
header('Content-type: text/javascript');
?>
throw new Error('出錯了'); 

再重新整理,這次所有資訊都正常捕獲了:

結論與兩個必要動作

我的 2048 遊戲靜態資源是放在獨立的靜態網域(非同源)下的,所以想靠 onerror 捕到有意義的錯誤訊息,就必須做到兩件事:

1. 為 script 加上 crossorigin 屬性。

2. 設定伺服器,讓靜態資源的 JavaScript 回應帶上 Access-Control-Allow-Origin。

這兩步都做,跨域腳本的錯誤才有行號、有欄位、有真正的訊息,上報才有意義。少了任何一步,你收集到的都只會是一堆 Script error——量很大,但一點線索都沒有。

實務上還值得補充兩點:一是 crossorigin 屬性生效需要瀏覽器支援,舊環境仍需容忍降級;二是收集到的錯誤應該去重與聚合上報,否則同一個錯誤被觸發上千次,反而會把真正重要的問題淹沒。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved