前幾天有個 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 這類通常走在標準草案前面,這些參數拿來用沒問題,但要為舊環境留退路。
<!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 屬性生效需要瀏覽器支援,舊環境仍需容忍降級;二是收集到的錯誤應該去重與聚合上報,否則同一個錯誤被觸發上千次,反而會把真正重要的問題淹沒。