前端项目中的Vue、React错误监听
一、 Vue 错误监听
题目:
如何统一监听 Vue 组件报错?
分析:
真实项目需要闭环,即考虑各个方面,除了基本的功能外,还要考虑性能优化、报错、统计等。 而个人项目、课程项目一般以实现功能为主,不会考虑这么全面。所以,没有实际工作经验的同学,不会了解如此全面。
window.onerror
可以监听当前页面所有的 JS 报错,jQuery 时代经常用。
注意,全局只绑定一次即可。不要放在多次渲染的组件中,这样容易绑定多次。
window.onerror = function(msg, source, line, column, error) { console.log('window.onerror---------', msg, source, line, column, error) } // 注意,如果用 window.addEventListener('error', event => {}) 参数不一样!!!
errorCaptured 生命周期
会监听所有下级组件的错误。可以返回 false
阻止向上传播,因为可能会有多个上级节点都监听错误。
errorCaptured(error, instance, info) { console.log('errorCaptured--------', error, instance, info) }
errorHandler
全局的错误监听,所有组件的报错都会汇总到这里来。PS:如果 errorCaptured
返回 false
则不会到这里。
const app = createApp(App) app.config.errorHandler = (error, instance, info) => { console.log('errorHandler--------', error, instance, info) }
请注意,errorHandler
会阻止错误走向 window.onerror
。
PS:还有 warnHandler
异步错误
组件内的异步错误 errorHandler
监听不到,还是需要 window.onerror
mounted() { setTimeout(() => { throw new Error('setTimeout 报错') }, 1000) },
答案
方式
errorCaptured
监听下级组件的错误,可返回false
阻止向上传播errorHandler
监听 Vue 全局错误window.onerror
监听其他的 JS 错误,如异步
建议:结合使用
- 一些重要的、复杂的、有运行风险的组件,可使用
errorCaptured
重点监听 - 然后用
errorHandler
window.onerror
候补全局监听,避免意外情况
扩展
Promise 监听报错要使用 window.onunhandledrejection
前端拿到错误监听之后,需要传递给服务端,进行错误收集和分析,然后修复 bug 。 后面会有一道面试题专门讲解。
二、React 错误监听
题目:
如何统一监听 React 组件报错?
分析:
真实项目需要闭环,即考虑各个方面,除了基本的功能外,还要考虑性能优化、报错、统计等。
ErrorBoundary
React 16+ 引入。可以监听所有下级组件报错,同时降级展示 UI 。
代码参考 ErrorBoundary.js 和 components/ErrorDemo
import React from 'react' class ErrorBoundary extends React.Component { constructor(props) { super(props) this.state = { error: null // 存储当前的报错信息 } } static getDerivedStateFromError(error) { // 更新 state 使下一次渲染能够显示降级后的 UI console.info('getDerivedStateFromError...', error) return { error } } componentDidCatch(error, errorInfo) { // 统计上报错误信息 console.info('componentDidCatch...', error, errorInfo) } render() { if (this.state.error) { // 提示错误 return <h1>报错了</h1> } // 没有错误,就渲染子组件 return this.props.children } } export default ErrorBoundary
FunctionalDemo.js
import { useState, useEffect } from 'react' function ErrorDemo() { const [num] = useState(100) function clickHandler() { num() // ErrorBoundary 无法监听事件报错,需要自行 try-catch } useEffect(() => { // throw new Error('mounted error') // ErrorBoundary 可监听渲染过程的报错 }, []) return <div> <p>error demo - functional</p> <button onClick={clickHandler}>error</button> </div> } export default ErrorDemo
建议应用到最顶层,监听全局错误
// index.js 入口文件 ReactDOM.render( <React.StrictMode> <ErrorBoundary> <App /> </ErrorBoundary> </React.StrictMode>, document.getElementById('root') );
函数组件中也可以使用
function App(props) { return <ErrorBoundary> {props.children} </ErrorBoundary> }
dev 和 build
dev 环境下无法看到 ErrorBoundary 的报错 UI 效果。会显示的提示报错信息。yarn build
之后再运行,即可看到 UI 效果。
事件报错
React 不需要 ErrorBoundary 来捕获事件处理器中的错误。与 render
方法和生命周期方法不同,事件处理器不会在渲染期间触发。
如果你需要在事件处理器内部捕获错误,使用普通的 try-catch
语句。也可以使用全局的 window.onerror
来监听。
异步错误
ErrorBoundary 无法捕捉到异步报错,可使用 window.onerror
来监听。
window.onerror = function(msg, source, line, column, error) { console.log('window.onerror---------', msg, source, line, column, error) } // 注意,如果用 window.addEventListener('error', event => {}) 参数不一样!!!
答案
- ErrorBoundary 监听渲染时报错
try-catch
和window.onerror
捕获其他错误
扩展
Promise 监听报错要使用 window.onunhandledrejection
前端拿到错误监听之后,需要传递给服务端,进行错误收集和分析,然后修复 bug 。