前端异常捕获按键没法点击、元素不展现、页面白屏，这些都是咱们前端不想看到的场景。在计算机程序运行的过程当中，也老是会出现

按键没法点击、元素不展现、页面白屏，这些都是咱们前端不想看到的场景。在计算机程序运行的过程当中，也老是会出现各类各样的异常。

1、前言

什么是异常，异常就是预料以外的事件，每每影响了程序的正确运行。例以下面几种场景：

页面元素异常（例如按钮没法点击、元素不展现）前端
页面卡顿
页面白屏

这些状况都是极其影响用户体验的。对于前端来讲，异常虽然不会致使计算机宕机，可是每每会致使用户的操做被阻塞。虽然异常不可彻底杜绝，可是咱们有充分的理由去理解异常、学习处理异常。web

异常处理在程序设计中的重要性是毋庸置疑的。任何有影响力的 Web 应用程序都须要一套完善的异常处理机制，但实际上，一般只有服务端团队会在异常处理机制上投入较大精力。虽然客户端应用程序的异常处理也一样重要，但真正受到重视，仍是最近几年的事。做为新世纪的杰出前端开发人员，咱们必须理解有哪些异常，当发生异常时咱们有哪些手段和工具能够利用。json

2、异常分类

从根本上来讲，异常就是一个数据结构，它存了异常发生时相关信息，譬如错误码、错误信息等。其中 message 属性是惟一一个可以保证全部浏览器都支持的属性，除此以外，IE、Firefox、Safari、Chrome 以及 Opera 都为事件对象添加了其它相关信息。譬如 IE 添加了与 message 属性彻底相同的 description 属性，还添加了保存这内部错误数量的 number 属性。Firefox 添加了 fileName、lineNumber 和 stack（包含堆栈属性）。因此，在考虑浏览器兼容性时，最好仍是只使用 message 属性。axios

执行 JS 期间可能会发生的错误有不少类型。每种错误都有对应的错误类型，而当错误发生的时候就会抛出响应的错误对象。ECMA-262 中定义了下列 7 种错误类型：

Error：错误的基类，其余错误都继承自该类型
EvalError：Eval 函数执行异常
RangeError：数组越界
ReferenceError：尝试引用一个未被定义的变量时，将会抛出此异常
SyntaxError：语法解析不合理
TypeError：类型错误，用来表示值的类型非预期类型时发生的错误
URIError：以一种错误的方式使用全局 URI 处理函数而产生的错误

3、异常处理

ECMA-262 第 3 版中引入了 try-catch 语句，做为 JavaScript 中处理异常的一种标准方式，基本的语法以下所示。这和 Java 中的 try-catch 语句是全完相同的。数组

try {
// 可能会致使错误的代码
}catch (error) {
// 在错误发生时怎么处理
}

若是 try 块中的任何代码发生了错误，就会当即退出代码执行过程，而后执行 catch 块。此时 catch 块会接收到一个包含错误信息的对象，这个对象中包含的信息因浏览器而异，但共同的是有一个保存着错误信息的 message 属性。

finally 子句在 try-catch 语句中是可选的，可是 finally 子句一经使用，其代码不管如何都会执行。换句话说，try 语句块中代码所有正常执行，finally 子句会执行；若是由于出错执行了 catch 语句，finally 子句照样会执行。只要代码中包含 finally 子句，则不管 try 或 catch 语句中包含什么代码——甚至是 return 语句，都不会阻止 finally 子句执行。来看下面函数的执行结果：

function testFinally {
  try {
    return "出去玩";
  } catch (error) {
    return "看电视";
  } finally {
    return "作做业";
  }
  return "睡觉";
}

表面上调用这个函数会返回 "出去玩"，由于返回 "出去玩" 的语句位于 try 语句块中，而执行此语句又不会出错。实际上返回 "作做业"，由于最后还有 finally 子句，结果就会致使 try 块里的 return 语句被忽略，也就是说调用的结果只能返回 "作做业"。若是把 finally 语句拿掉，这个函数将返回 "出去玩"。所以，在使用 finally 子句以前，必定要很是清楚你想让代码怎么样。（思考一下若是 catch 块和 finally 块都抛出异常，catch 块的异常是否能抛出）

但使人遗憾的是，try-catch 没法处理异步代码和一些其余场景。接下来让我具体分析几种异常场景及其处理方案。

4、异常分析

1. JS 代码错误

TypeError 类型在 JavaScript 中会常常遇到，在变量中保存着意外类型时，或者在访问不存在的方法时，都会致使这种错误。错误的缘由虽然多种多样，但归根结底仍是因为在执行特定类型的操做时，变量的类型并不符合要求所致。再看几个例子：

class People{
  constructor(name) {
    this.name = name;
  }
  sing() {}
}
const xiaoming = new People("小明");
xiaoming.dance();// 抛出 TypeError
xiaoming.girlfriend.name;// 抛出 TypeError

代码错误通常在开发和测试阶段就能发现。用 try-catch 也能捕获到：

// 代码
try {
  xiaoming.girlfriend.name;
} catch (error) {
  console.log(xiaoming.name + "没有女友", error);
}
// 运行结果
// 小明没有女友 TypeError: Cannot read property 'name' of undefined

2. JS 语法错误

咱们修改一下代码，咱们把英文分号改为中文分号:

try {
  xiaoming.girlfriend.name；// 结尾是中文分号
} catch(error) {
  console.log(xiaoming.name + "没有女友", error);
}
// 运行结果
// Uncaught SyntaxError: Invalid or unexpected token

SyntaxError 语法错误咱们没法经过 try-catch 捕获到，不过语法错误在咱们开发阶段就能够看到，应该不会顺利上到线上环境。

不过凡事总有例外，线上仍是能收到一些语法错误的告警，但多半是 JSON 解析出错和浏览器兼容性致使。

再看几个例子：

JSON.parse('{name:xiaoming}');// Uncaught SyntaxError: Unexpected token n in JSON at position 1
JSON.parse('{"name":xiaoming}');// Uncaught SyntaxError: Unexpected token x in JSON at position 8
JSON.parse('{"name":"xiaoming"}');// 正常
var testFunc () => { };// 在 IE 下会抛出 SyntaxError，由于 IE 不支持箭头函数，须要经过Babel等工具事先转译下

使用 JSON.parse 解析时出现异常就是一个很好的使用 try-catch 的场景：

try {
  JSON.parse(remoteData);// remoteData 为服务端返回的数据
} catch {
  console.error("服务端数据格式返回异常，没法解析", remoteData);
}

并非捕获到错误就结束了，捕获到错误后，咱们须要思考当错误发生时：

错误是不是致命的，会不会致使其它连带错误
后续的代码逻辑还能不能继续执行，用户还能不能继续操做
是否是须要将错误信息反馈给用户，提示用户如何处理该错误
是否是须要将错误上报服务端

对应上面的问题这里就会有不少解决方案了，譬如：

若是是服务器未知异常致使，能够阻塞用户操做，弹窗提示用户"服务器异常，请稍后重试"。并提供给用户一个刷新的按钮；

try {
  return JSON.parse(remoteData);
} catch (error) {
  Modal.fail("服务器异常，请稍后重试");
  return false;
}

若是是数据异常致使，可阻塞用户操做，弹窗提示用户"服务器异常，请联系客服处理~"，同时将错误信息上报异常服务器，开发人员经过异常堆栈和用户埋点定位问题缘由；

try {
  return JSON.parse(remoteData);
} catch (error) {
  Modal.fail("服务器异常，请联系客服处理~");
  logger.error("JSON数据解析出现异常", error);
  return false;
}

若是数据解析出错属于预料之中的状况，也有替代的默认值，那么当解析出错时直接使用默认值也能够；

try {
  return JSON.parse(remoteData);
} catch (error) {
  console.error("服务端数据格式返回异常，使用本地缓存数据", erorr);
  return localData;
}

任何错误处理策略中最重要的一个部分，就是肯定错误是否致命。

3. 异步错误

try {
  setTimeout(() => {
    undefined.map(v => v);
  }, 1000)
} catch(e) {
  console.log("捕获到异常：", e);
}

Uncaught TypeError: Cannot read property 'map' of undefined
  at <anonymous>:3:15

并无捕获到异常，try-catch 对语法和异步错误却无能为力，捕获不到，这是须要咱们特别注意的地方。

5、异常捕获

5.1 window.onerror

当 JS 运行时错误发生时，window 会触发一个 ErrorEvent 接口的 error 事件，并执行**window.onerror()**。

/**
 *@param{String}message    错误信息
 *@param{String}source     出错文件
 *@param{Number}lineno     行号
 *@param{Number}colno      列号
 *@param{Object}error      Error对象（对象）
 */
window.onerror = function (message, source, lineno, colno, error) {
  console.log("捕获到异常：", { message, source, lineno, colno, error });
};

同步错误能够捕获到，可是，请注意 window.error 没法捕获静态资源异常和 JS 代码错误。

5.2 静态资源加载异常

方法一：onerror 来捕获

<script>
  function errorHandler(error) {
    console.log("捕获到静态资源加载异常", error);
  }
</script>
<script src="<http://cdn.xxx.com/js/test.js>" onerror="errorHandler(this)"></script>
<link rel="stylesheet" href="<http://cdn.xxx.com/styles/test.css>" onerror="errorHandler(this)">

这样能够拿到静态资源的错误，但缺点很明显，代码的侵入性太强了，每个静态资源标签都要加上 onerror 方法。

方法二：addEventListener("error")

**<!DOCTYPE html>**
<html lang="zh"> 
<head>  
<meta charset="UTF-8">  
<meta name="viewport" content="width=device-width, initial-scale=1.0">  
<title>error</title>  
<script>    
window.addEventListener('error', (error) => {      
console.log('捕获到异常：', error);    
}, true)  
</script>
</head> 
<body>  
<img src="<https://itemcdn.zcycdn.com/15af41ec-e6cb-4478-8fad-1a47402f0f25.png>">
</body> 
</html>

因为网络请求异常不会事件冒泡，所以必须在捕获阶段将其捕捉到才行，可是这种方式虽然能够捕捉到网络请求的异常，可是没法判断 HTTP 的状态是 404 还是其余好比 500 等等，因此还须要配合服务端日志才进行排查分析才能够。

5.3 Promise 异常

Promise 中的异常不能被 try-catch 和 window.onerror 捕获，这时候咱们就须要监听 unhandledrejection 来帮咱们捕获这部分错误。

window.addEventListener("unhandledrejection", function (e) {
  e.preventDefault();
  console.log("捕获到 promise 错误了");
  console.log("错误的缘由是", e.reason);
  console.log("Promise 对象是", e.promise);
  return true;
});

Promise.reject("promise error");
new Promise((resolve, reject) => {
  reject("promise error");
});
new Promise((resolve) => {
  resolve();
}).then(() => {
  throw "promise error";
});

5.4 React 异常

React 处理异常的方式不一样。虽然 try-catch 适用于许多非普通 JavaScript 应用程序，但它只适用于命令式代码。由于 React 组件是声明性的，因此 try-catch 不是一个可靠的选项。为了弥补这一点，React 实现了所谓的错误边界。错误边界是 React 组件，它“捕获子组件树中的任何地方的 JavaScript 错误”，同时还记录错误并显示回退用户界面。

class ErrorBoundaryextendsReact.Component{
constructor(props) {
super(props);
    this.state = { hasError: false };
  }

  componentDidCatch(error, info) {
// 展现出错的UI
    this.setState({ hasError: true });
// 将错误信息上报到日志服务器
    logErrorToMyService(error, info);
  }

  render() {
    if (this.state.hasError) {
// 能够展现自定义的错误样式
      return <h1>Something went wrong.</h1>;
    }
    return this.props.children;
  }
}

可是须要注意的是， error boundaries 并不会捕捉下面这些错误：

事件处理器
异步代码
服务端的渲染代码
在 error boundaries 区域内的错误

咱们能够这样使用 ErrorBoundary：

<ErrorBoundary>
  <MyWidget />
</ErrorBoundary

5.5 Vue 异常

Vue.config.errorHandler = (err, vm, info) => {
  console.error("经过vue errorHandler捕获的错误");
  console.error(err);
  console.error(vm);
  console.error(info);
};

5.6 请求异常

以最经常使用的 HTTP 请求库 axios 为例，模拟接口响应 401 的状况：

// 请求
axios.get(/api/test/401")
// 结果
Uncaught (in promise) Error: Request failed with status code 401
at createError (axios.js:1207)
at settle (axios.js:1177)
at XMLHttpRequest.handleLoad (axios.js:1037)

能够看出来 axios 的异常能够当作 Promise 异常来处理：

// 请求
axios.get("<http://localhost:3000/api/uitest/sentry/401>")
.then(data => console.log('接口请求成功', data))
.catch(e => console.log('接口请求出错', e));
// 结果
接口请求出错 Error: Request failed with status code 401
at createError (createError.js:17)
at settle (settle.js:18)
at XMLHttpRequest.handleLoad (xhr.js:62)

通常接口 401 就表明用户未登陆，就须要跳转到登陆页，让用户进行从新登陆，但若是每一个请求方法都须要写一遍跳转登陆页的逻辑就很麻烦了，这时候就会考虑使用 axios 的拦截器来作统一梳理，同理能统一处理的异常也能够在放在拦截器里处理。

// Add a response interceptor
axios.interceptors.response.use(
  function (response) {
// Any status codes that falls outside the range of 2xx cause this function to trigger
// Do something with response error
  },
  function (error) {
    if (error.response.status === 401) {
      goLogin();// 跳转登陆页
    } else if (error.response.status === 502) {
      alert(error.response.data.message || "系统升级中，请稍后重试");
    }
    return Promise.reject(error.response);
  }
);

5.7 总结

异常一共七大类，处理时需分清是致命错误仍是非致命错误。

可疑区域增长 try-catch
全局监控 JS 异常 window.onerror
全局监控静态资源异常 window.addEventListener
捕获没有 catch 的 Promise 异经常使用 unhandledrejection
Vue errorHandler 和 React componentDidCatch
Axios 请求统一异常处理用拦截器 interceptors
使用日志监控服务收集用户错误信息

6、异常上报

即便咱们前端开发完成后，会有一系列的 Web 应用的上线前的验证，如自测、QA 测试、code review 等，以确保应用能在生产上没有事故。

可是事与愿违，不少时候咱们都会接到客户反馈的一些线上问题，这些问题有时候多是你本身代码的问题。这样的问题通常可以在测试环境重现，咱们很快的能定位到问题关键位置。可是，不少时候有一些问题，咱们在测试中并未发现，但是在线上却有部分人出现了，问题确确实实存在的，这个时候咱们测试环境又不能重现，还有一些偶现的生产的偶现问题，这些问题都很难定位到问题的缘由，让咱们前端工程师头疼不已。

而咱们不可能每次都远程给用户解决问题，或者让用户按 F12 打开浏览器控制台把错误信息截图给咱们吧。这时候，咱们不得不借助一些工具来解决这一系列使人头疼的问题。

前端错误监控日志系统就应用而生。当前端代码在生产运行中出现错误的时候，第一时间传递给监控系统，从而第一时间定位而且解决问题。

有不少成熟的方案可供选择：ARMS、fundebug、BadJS、Sentry。# 前端异常捕获