萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

整合 Raygun 實現 AngularJS 應用自動異常追蹤

AngularJS 擁有優異的異常拋出機制,錯誤堆疊資訊往往能精準定位崩潰原因。然而,分散於全球各瀏覽器、裝置的大型客戶端應用,異常資訊極易流失。若能自動收集這些錯誤,將大幅提升除錯效率與使用者留存。Raygun 提供零侵入式的自動異常追蹤服務,幾分鐘即可完成整合。

安裝 Raygun4JS

三種取得方式任選一:

  • Bower: bower install raygun4js
  • NuGet (Visual Studio): Install-Package raygun4js
  • 手動下載: 官網提供開發版與壓縮版

初始化配置

引入腳本後,在 Angular 主邏輯啟動前呼叫初始化:

Raygun.init('YOUR_API_KEY').attach();

API Key 可於 Raygun 儀表板建立應用後獲取,提供 30 天免費試用。

攔截 Angular 異常:$exceptionHandler 裝飾器模式

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 覆寫

若不需保留原始行為,可直接用 Factory 覆寫 $exceptionHandler:

app.factory('$exceptionHandler', function () {
  return function (exception) { Raygun.send(exception); };
});

注意:此方式會移除控制台預設日誌,若需保留須手動轉發。

手動發送自訂錯誤

隨時可主動上報業務邏輯錯誤:

Raygun.send(new Error('my custom error'));

額外優勢

  • 自動追蹤 jQuery Ajax 錯誤,無需額外配置
  • 支援使用者唯一識別、版本追蹤、標籤分類等豐富維度
  • 完整文檔參考官方 API 文件

立即接入 Raygun,讓每一個生產環境異常都能被看見、被解決。

copyright © 萬盛學電腦網 all rights reserved