AngularJS 其中一項實用設計,是它會主動把例外丟出來——這些資訊往往能準確指出程式碼為何崩潰。但對於運行在全球無數瀏覽器上的大型客戶端應用來說,例外很容易就消失在客戶的 console 裡。把它捕捉起來,才有機會修掉 bug。
跨瀏覽器、跨裝置的問題尤其需要這些資料:你的應用在自己的開發機上跑得好好的,到了使用者手上卻是另一回事。Raygun 這類自動例外追蹤服務的價值就在於此,而它接入 Angular 應用的方式相當輕量。
先取得體積很小的 Raygun4JS 腳本,有三種方式:
# 透過 Bower bower install raygun4js
// 在 Visual Studio 的套件管理員主控台中 Install-Package raygun4js
或直接下載 dev 版/壓縮版檔案。
接著在 Angular 主邏輯執行之前完成初始化:
Raygun.init('YOUR_API_KEY').attach();
每個 app 都會有自己的 API key,可在 Raygun 儀表板中找到。官方提供 30 天免費試用。
把未處理的例外導向 Raygun,至少有兩種做法: decorator 或 factory。兩者都是取得 $exceptionHandler 的實作,再把它交給 Raygun4JS 送出。
裝飾器模式的優點是不覆蓋原有行為,能在保留既有特性的同時注入新邏輯,因此很適合用來加日誌、發例外報告。在 Angular 中它可搭配 $provide 服務使用:
app.config(function ($provide) {
$provide.decorator("$exceptionHandler", ['$delegate', function ($delegate) {
return function (exception, cause) {
Raygun.send(exception);
$delegate(exception, cause);
};
}]);
});
$delegate 是原本的例外處理器,呼叫它就能保留輸出到 console 的原始行為。也可以額外注入其他服務:
$provide.decorator("$exceptionHandler", ['$delegate', '$log', function ($delegate, $log) {
return function (exception, cause) {
$log.debug('Sending to Raygun');
Raygun.send(exception);
$delegate(exception, cause);
};
}]);
cause 參數的內容取決於例外是從哪裡拋出的。若想把它一起送進 Raygun 作為自訂資料,可以改寫 send 呼叫:
Raygun.send(exception, { cause: cause });
最快的方式是直接覆寫服務,代價是會失去原本的控制台日誌;若需要保留,得先存下原值再自行呼叫:
app.factory('$exceptionHandler', function () {
return function (exception) {
Raygun.send(exception);
};
});
隨時手動追蹤特定錯誤也很容易:
Raygun.send(new Error('my custom error'));
此外,服務還提供使用者追蹤、版本追蹤、標籤等工具,詳細資訊可查閱官方文件。Raygun 甚至能自動追蹤 Angular 應用中 jQuery 引發的 Ajax 錯誤,不必額外設定就能開箱即用。
官方提供 30 天免費、免信用卡的試用方案,可以先接上去看看你的應用是否真如預期般在使用者端正常運作。