詳解JavaScript錯誤捕獲和上報流程

  • 2019 年 11 月 24 日
  • 筆記

怎麼捕獲錯誤並且處理,是一門語言必備的知識。在JavaScript中也是如此。

那怎麼捕獲錯誤呢?初看好像很簡單,try-catch就可以了嘛!但是有的時候我們發現情況卻繁多複雜。

  • Q1: 同步可以try-catch,但一個非同步回調,比如setTimeOut里的函數還可以try-catch嗎?
  • Q2: Promise的錯誤捕獲怎麼做?
  • Q3: async/await怎麼捕獲錯誤?
  • Q4: 我能夠在全局環境下捕獲錯誤並且處理嗎?
  • Q5: React16有什麼新的錯誤捕獲方式嗎?
  • Q6: 捕獲之後怎麼上報和處理?

問題有點多,我們一個一個來。

Q1. 同步程式碼里的錯誤捕獲方式

在同步程式碼里,我們是最簡單的,只要try-catch就完了

function test1 () {    try {      throw Error ('callback err');    } catch (error) {      console.log ('test1:catch err successfully');    }  }  test1();

輸出結果如下,顯然是正常的

Q2. 普通的非同步回調里的錯誤捕獲方式(Promise時代以前)

上面的問題來了,我們還能通過直接的try-catch在非同步回調外部捕獲錯誤嗎?我們試一試

// 嘗試在非同步回調外部捕獲錯誤的結果  function test2 () {    try {      setTimeout (function () {        throw Error ('callback err');      });    } catch (error) {      console.log ('test2:catch err successfully');    }  }  test2(); 

輸出

注意這裡的Uncaught Error的文本,它告訴我們錯誤沒有被成功捕捉。

為什麼呢? 因為try-catch的是屬於同步程式碼,它執行的時候,setTimeOut內部的的匿名函數還沒有執行呢。而內部的那個匿名函數執行的時候,try-catch早就執行完了。( error的內心想法:哈哈,只要我跑的夠慢,try-catch還是追不上我!)

但是我們簡單想一想,誒我們把try-catch寫到函數裡面不就完事了嘛!

function test2_1 () {    setTimeout (function () {      try {        throw Error ('callback err');      } catch (error) {        console.log ('test2_1:catch err successfully');      }    });  }  test2_1();

輸出結果如下,告訴我們這方法可行

總結下Promise時代以前,非同步回調中捕獲和處理錯誤的方法

  • 在非同步回調內部編寫try-catch去捕獲和處理,不要在外部哦
  • 很多非同步操作會開放error事件,我們根據事件去操作就可以了

Q3. Promise里的錯誤捕獲方式

可通過Promise.catch方法捕獲

function test3 () {    new Promise ((resolve, reject) => {      throw Error ('promise error');    }).catch (err => {      console.log ('promise error');    });  }

輸出結果

>> reject方法調用和throw Error都可以通過Promise.catch方法捕獲

function test4 () {    new Promise ((resolve, reject) => {      reject ('promise reject error');    }).catch (err => {      console.log (err);    });  } 

輸出結果

>> then方法中的失敗回調和Promise.catch的關係

  • 如果前面的then方法沒寫失敗回調,失敗時後面的catch是會被調用的
  • 如果前面的then方法寫了失敗回調,又沒拋出,那麼後面的catch就不會被調用了
// then方法沒寫失敗回調  function test5 () {    new Promise ((resolve, reject) => {      throw Error ('promise error');    })      .then (success => {})      .catch (err => {        console.log ('the error has not been swallowed up');      });  }  // then方法寫了失敗回調  function test5 () {    new Promise ((resolve, reject) => {      throw Error ('promise error');    })      .then (success => {},err => {})      .catch (err => {        console.log ('the error has not been swallowed up');      });  }

輸出分別為

1.the error has not been swallowed up
2.無輸出

Q4.async/await里的錯誤捕獲方式

對於async/await這種類型的非同步,我們可以通過try-catch去解決

async function test6 () {    try {      await getErrorP ();    } catch (error) {      console.log ('async/await error with throw error');    }  }    function getErrorP () {    return new Promise ((resolve, reject) => {      throw Error ('promise error');    });  }  test6();

輸出結果如下

>> 如果被await修飾的Promise因為reject調用而變化,它也是能被try-catch的

(我已經證明了這一點,但是這裡位置不夠,我寫不下了)

Q5.在全局環境下如何監聽錯誤

window.onerror可以監聽全局錯誤,但是很顯然錯誤還是會拋出

window.onerror = function (err) {    console.log ('global error');  };  throw Error ('global error');

輸出如下

Q6.在React16以上如何監聽錯誤

>> componentDidCatch和getDerivedStateFromError鉤子函數

class Bar extends React.Component {    // 監聽組件錯誤    componentDidCatch(error, info) {      this.setState({ error, info });    }    // 更新 state 使下一次渲染能夠顯示降級後的 UI    static getDerivedStateFromError(error) {      return { hasError: true };    }    render() {    }  }

有錯誤,那肯定要上報啊!不上報就發現不了Bug這個樣子。Sentry這位老哥就是個人才,日誌記錄又好看,每次見面就像回家一樣

Sentry簡單介紹

Sentry provides open-source and hosted error monitoring that helps all software teams discover, triage, and prioritize errors in real-time. One million developers at over fifty thousand companies already ship better software faster with Sentry. Won』t you join them? —— Sentry官網

Sentry是一個日誌上報系統,Sentry 是一個實時的日誌記錄和匯總處理的平台。專註於錯誤監控,發現和數據處理,可以讓我們不再依賴於用戶回饋才能發現和解決線上bug。讓我們簡單看一下Sentry支援哪些語言和平台吧

在JavaScript領域,Sentry的支援也可以說是面面俱到

參考鏈接  https://docs.sentry.io/platforms/ 

Sentry的功能簡單說就是,你在程式碼中catch錯誤,然後調用Sentry的方法,然後Sentry就會自動幫你分析和整理錯誤日誌,例如下面這張圖截取自Sentry的網站中

在JavaScript中使用Sentry

1.首先呢,你當然要註冊Sentry的帳號

這個時候Sentry會自動給你分配一個唯一標示,這個標示在Sentry里叫做 dsn

2. Android模組並使用基礎功能

安裝@sentry/browser

npm install @sentry/browser

在項目中初始化並使用

import * as Sentry from '@sentry/browser';    Sentry.init ({    dsn: 'xxxx',  });    try {    throw Error ('我是一個error');  } catch (err) {      // 捕捉錯誤    Sentry.captureException (err);  }

3.上傳sourceMap以方便在線上平台閱讀出錯的源碼

// 安裝  $ npm install --save-dev @sentry/webpack-plugin  $ yarn add --dev @sentry/webpack-plugin    // 配置webpack  const SentryWebpackPlugin = require('@sentry/webpack-plugin');  module.exports = {    // other configuration    plugins: [      new SentryWebpackPlugin({        include: '.',        ignoreFile: '.sentrycliignore',        ignore: ['node_modules', 'webpack.config.js'],        configFile: 'sentry.properties'      })    ]  }; 

4. 為什麼不是raven.js?

// 已經廢棄,雖然你還是可以用  var Raven = require('raven-js');  Raven    .config('xxxxxxxxxxx_dsn')    .install();

Sentry的核心功能總結

捕獲錯誤

try {    aFunctionThatMightFail();  } catch (err) {    Sentry.captureException(err);  }

設置該錯誤發生的用戶資訊

下面每個選項都是可選的,但必須 存在一個選項 才能使Sentry SDK捕獲用戶: id

Sentry.setUser({      id:"penghuwan12314"    email: "[email protected]",    username:"penghuwan",    ip_addressZ:'xxx.xxx.xxx.xxx'    });

設置額外數據

Sentry.setExtra("character_name", "Mighty Fighter");
設置作用域 
Sentry.withScope(function(scope) {      // 下面的set的效果只存在於函數的作用域內    scope.setFingerprint(['Database Connection Error']);    scope.setUser(someUser);    Sentry.captureException(err);  });  // 在這裡,上面的setUser的設置效果會消失

設置錯誤的分組

整理日誌資訊,避免過度冗餘

Sentry.configureScope(function(scope) {    scope.setFingerprint(['my-view-function']);  });

設置錯誤的級別

在閱讀日誌時可以確定各個bug的緊急度,確定排查的優先書序

Sentry.captureMessage('this is a debug message', 'debug');  //fatal,error,warning,info,debug五個值  // fatal最嚴重,debug最輕

自動記錄某些事件

例如下面的方法,會在每次螢幕調整時完成上報

window.addEventListener('resize', function(event){    Sentry.addBreadcrumb({      category: 'ui',      message: 'New window size:' + window.innerWidth + 'x' + window.innerHeight,      level: 'info'    });  })

Sentry實踐的運用

根據環境設置不同的dsn

let dsn;    if (env === 'test') {      dsn = '測試環境的dsn';    } else {      dsn =        '正式環境的dsn';    }    Sentry.init ({    dsn  });