详解JavaScript错误捕获和上报流程

怎么捕获错误并且处理，是一门语言必备的知识。在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. 安卓模块并使用基础功能

安装@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: "penghuwan@example.com",
  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
});