AngularJS 擁有優異的異常拋出機制,錯誤堆疊資訊往往能精準定位崩潰原因。然而,分散於全球各瀏覽器、裝置的大型客戶端應用,異常資訊極易流失。若能自動收集這些錯誤,將大幅提升除錯效率與使用者留存。Raygun 提供零侵入式的自動異常追蹤服務,幾分鐘即可完成整合。
三種取得方式任選一:
bower install raygun4jsInstall-Package raygun4js引入腳本後,在 Angular 主邏輯啟動前呼叫初始化:
Raygun.init('YOUR_API_KEY').attach();
API Key 可於 Raygun 儀表板建立應用後獲取,提供 30 天免費試用。
Angular 允許透過 $provide.decorator 擴充 $exceptionHandler 服務,保留原有控制台輸出行為同時轉發至 Raygun:
app.config(function ($provide) {
$provide.decorator("$exceptionHandler", ['$delegate', function($delegate) {
return function (exception, cause) {
Raygun.send(exception);
$delegate(exception, cause); // 保留原始控制台輸出
};
}]);
});
進階用法可注入 $log 記錄除錯資訊,或附加自訂資料(如 cause 參數)豐富錯誤上下文:
Raygun.send(exception, { cause: cause });
若不需保留原始行為,可直接用 Factory 覆寫 $exceptionHandler:
app.factory('$exceptionHandler', function () {
return function (exception) { Raygun.send(exception); };
});
注意:此方式會移除控制台預設日誌,若需保留須手動轉發。
隨時可主動上報業務邏輯錯誤:
Raygun.send(new Error('my custom error'));
立即接入 Raygun,讓每一個生產環境異常都能被看見、被解決。