DIV CSS 佈局教程網

用 Raygun 自動追蹤 AngularJS 中的例外
編輯:JavaScript綜合知識     

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 天免費試用。

在 Angular 中捕捉例外

把未處理的例外導向 Raygun,至少有兩種做法: decorator 或 factory。兩者都是取得 $exceptionHandler 的實作,再把它交給 Raygun4JS 送出。

做法一:使用 decorator

裝飾器模式的優點是不覆蓋原有行為,能在保留既有特性的同時注入新邏輯,因此很適合用來加日誌、發例外報告。在 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 });

做法二:使用 factory

最快的方式是直接覆寫服務,代價是會失去原本的控制台日誌;若需要保留,得先存下原值再自行呼叫:

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

手動回報

隨時手動追蹤特定錯誤也很容易:

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

此外,服務還提供使用者追蹤、版本追蹤、標籤等工具,詳細資訊可查閱官方文件。Raygun 甚至能自動追蹤 Angular 應用中 jQuery 引發的 Ajax 錯誤,不必額外設定就能開箱即用。

準備好試了嗎

官方提供 30 天免費、免信用卡的試用方案,可以先接上去看看你的應用是否真如預期般在使用者端正常運作。

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