JavaScript异步编程——11-异常处理方案【万字长文，感谢支持】

被瞧不起的神2024-05-15 15:22

异常处理方案

在JS开发中，处理 异常包括两步：先抛出 异常，然后捕获异常。

为什么要做异常处理

异常处理非常重要，至少有以下几个原因：

  1. 防止程序报错甚至停止运行：当代码执行过程中发生错误或异常时，如果没有适当的异常处理机制，程序可能会报错、停止运行，甚至崩溃。通过处理异常，我们可以捕获错误并采取适当的措施避免系统报错。

  2. 错误排查和调试：异常处理有助于定位和排查错误。可以通过捕获异常并输出相关信息，比如打印日志、错误上报、跟踪堆栈等等，以便快速定位问题所在，并进行调试和修复。

  3. 提高代码健壮性和可靠性：可以采取适当的措施处理潜在的异常情况，从而减少程序出错的可能性。

  4. 提升用户体验：通过兜底、容错、容灾等异常处理方案，可以向用户提供有效的错误信息提示，而不是让用户界面无响应甚至白屏。

抛出异常

抛出异常的使用场景举例：

我们经常会封装一些工具函数，这些函数可能给自己用，也可能给外部团队用。

在函数内部，如果不符合预期的业务逻辑，或者遇到异常情况时，很多人的写法是直接 return，不往下执行了。但是 return 的写法存在一个很大的弊端：调用者不知道是因为函数内部没有正常执行，还是执行的返回结果就是一个undefined 。return 的写法只是规避了问题，没有解决问题。建议的做法是：我们需要手动抛出异常。

捕获异常

如果只是抛出异常，而不捕获异常的话，是比较危险的。这意味着当前任务立即终止，不再执行（当然，后续的其他任务会正常执行）。此外，这个异常信息会层层往上，抛给上层的调用者 。如果一直未被捕获，则最终会抛给浏览器，浏览器控制台就会报错。

接下来，我们看一下不同代码场景下的异常处理方案。

上报异常

如果有必要的话，你可以把异常信息和日志，上报给监控服务器，然后集中分析。我每天上班第一件事，就是打开监控系统，看错误日志，然后对症下药解决问题。

同步代码的异常处理

通过 throw 抛出异常

我们可以通过 throw关键字，抛出一个用户自定义 的异常。当代码执行时遇到 throw 语句时，当前函数会停止停止，即：当前函数 throw 后面的代码不会再执行。

throw 意思是，告诉调用者，当前被调用的函数报错了，调用者接下来需要捕获异常或者修改代码逻辑。

可以在 throw 的后面添加表达式或者数据类型，将添加的内容抛出去。数据类型可以是：number、string、boolean、对象等。

代码举例：

复制代码 
 function sum(num1, num2) {
   if (typeof num1 !== "number") {
     throw "type error: num1传入的类型有问题, 必须是number类型"
   }
 ​
   if (typeof num2 !== "number") {
     throw "type error: num2传入的类型有问题, 必须是number类型"
   }
 ​
   return num1 + num2
 }
 ​
 sum('a', 'b');

打印结果：

当然，我们还可以 throw一个封装好的对象。比如：

复制代码 
 class myError {
   constructor(errCode, errMsg) {
     this.errCode = errMsg;
     this.errMsg = errMsg;
   }
 }
 ​
 function foo() {
   throw new myError(-1, 'not login');
 }
 ​
 foo();

上面这种写法比较麻烦，一般不这么写。其实，JS中已经内置了 Error 类，专门用于生成错误信息。

Error 类

JS内置的 Error 类非常好用。

代码举例：

复制代码 
 function foo() {
   throw new Error('not login');
 }
 ​
 ​
 foo();

打印结果：

上面的打印结果可以看到，通过 Error 抛出来的错误，不仅可以看到报错信息，还可以看到调用栈，便于快速定位问题所在。非常方便。

通过 try catch 捕获异常

同步代码，只抛出异常，不捕获异常的代码举例：

复制代码 
 function foo() {
   throw new Error('not login');
 }
 ​
 foo();
 // 当前任务立即终止，不再执行；下面这行代码和 foo() 都在同一个 同步任务 中
 console.log('qianguyihao');

打印结果：

可以看到，最后一行的 log 并没有执行。

我们可以使用 try catch 抛出异常， 对上述代码进行改进。代码举例：

复制代码 
 function foo() {
   throw new Error('not login');
 }
 ​
 // 通过 try catch 手动捕获异常
 try {
   foo();
 } catch (err) {
   console.log(err);
 }
 ​
 // 当前任务的后续代码会继续执行
 console.log('qianguyihao');

打印结果：

通过 try catch finally 捕获异常

如果有些代码必须要执行，我们可以放到 finally 里。

  • 不管是否遇到异常，finally的代码一定会执行。

  • 如果 try 和 finally 中都有返回值，那么会使用finally中的返回值。

代码举例：

复制代码 
 function foo() {
   throw new Error('not login');
 }
 ​
 // 通过 try catch 捕获异常
 try {
   foo();
 } catch (err) {
   console.log(err);
 } finally {
   console.log("finally")
 }
 ​
 // 后续代码会继续执行
 console.log('qianguyihao');

try catch 只能捕获同步代码的异常

try catch只能捕获同步代码里的异常，而 Promise.reject() 是异步代码。

原因是：当异步函数抛出异常时，对于宏任务而言，执行函数时已经将该函数推入栈，此时并不在 try-catch 所在的栈，所以 try-catch 并不能捕获到错误。对于微任务而言（比如 promise）promise 的构造函数的异常只能被自带的 reject 也就是.catch 函数捕获到。

参考链接：

使用 window.onerror 监听未被捕获的代码异常

如果JS代码抛出了异常但没有进行捕获，我们可以使用 JS 自带的 window.onerror 事件监听到这些错误。

代码举例：

复制代码 
 // 监听同步代码的异常
 window.onerror = (event) => {
   console.error('onerror 监听到未被捕获的异常:', event)
 };
 ​
 function foo1() {
   throw new Error('not login');
 }
 ​
 function foo2() {
   throw new Error('network error');
 }
 ​
 foo1();
 foo2();

打印结果：

Promise 的异常处理

reject() 会自动抛出异常

在使用 Promise 时，当我们调用了 reject() 之后，系统会自动抛出异常，不需要我们手动抛出异常。这是 Promise的内部机制。但是我们需要手动捕获异常。

当 Promise 进入 rejected状态之后，会触发 catch()方法的执行，捕获异常。此时，成功完成了Promise异常处理的闭环。

在then() 中抛出异常（重要）

当then()方法传入的回调函数中，如果遇到异常或者手动抛出异常，那么，then()所返回的新的 Promise 会进入rejected 状态，进而触发新Promise 的 catch() 方法的执行，做异常捕获。

场景1 ：在then()方法传入的回调函数中，如果代码在执行时遇到异常 ，系统会自动抛出异常 。此时我们需要在 catch() 里手动捕获异常，否则会报错。

自动抛出异常的代码举例：（由于没有捕获异常，所以会报错）

复制代码 
 const myPromise = new Promise((resolve, reject) => {
   resolve('qianguyihao1 fulfilled');
 });
 ​
 myPromise.then(res => {
   console.log('res1:', res);
   // 显然，person 并没有 forEach()方法。所以，代码在执行时，会遇到异常。
   const person = { name: 'vae' };
   person.forEach(item => {
     console.log('item:', item);
   })
   // 这行代码不会执行，因为上面的代码报错了
   console.log('qianguyihao2');
 }).then(res => {
   console.log('res2:', res);
 })
 ​
 // 定时器里的代码正常执行
 setTimeout(() => {
   console.log('qianguyihao3');
 }, 100)

运行结果：

代码改进：（代码在执行时遇到异常，此时我们捕获异常，所以系统不会报错，这才是推荐的写法）

复制代码 
const myPromise = new Promise((resolve, reject) => {
  resolve('qianguyihao1 fulfilled');
});

myPromise.then(res => {
  console.log('res1:', res);
  // 显然，person 并没有 forEach()方法。所以，代码在执行时，会遇到异常。
  const person = { name: 'vae' };
  person.forEach(item => {
    console.log('item:', item);
  })
  // 这行代码不会执行，因为上面的代码报错了
  console.log('qianguyihao2');
}).then(res => {
  console.log('res2:', res);
}).catch(err => {
  // 在 catch()方法传入的会调函数里，捕获异常
  console.log('err2:', err);
})

// 定时器里的代码正常执行
setTimeout(() => {
  console.log('qianguyihao3');
}, 100)

打印结果：

场景2 ：在then()方法传入的回调函数中，如果我们手动抛出异常，此时我们需要在 catch() 里手动捕获异常，否则会报错。

代码举例：（手动抛出异常，未捕获，所以会报错）

复制代码 
const myPromise = new Promise((resolve, reject) => {
  resolve('qianguyihao fulfilled 1');
});

myPromise.then(res => {
  console.log('res1:', res);
  // 手动抛出异常
  throw new Error('qianguyihao rejected 2')
}).then(res => {
  console.log('res2:', res);
})

// 定时器里的代码正常执行
setTimeout(() => {
  console.log('qianguyihao3');
}, 100)

打印结果：

代码改进：（代码在执行时遇到异常，此时我们捕获异常，所以系统不会报错，这才是推荐的写法）

复制代码 
const myPromise = new Promise((resolve, reject) => {
  resolve('qianguyihao fulfilled 1');
});

myPromise.then(res => {
  console.log('res1:', res);
  // 手动抛出异常
  throw new Error('qianguyihao rejected 2')
}).then(res => {
  console.log('res2:', res);
}, (err) => {
  console.log('err2:', err);
})

// 定时器里的代码正常执行
setTimeout(() => {
  console.log('qianguyihao3');
}, 100)

打印结果：

使用 unhandledrejection 事件监听未被捕获的Promise异常

如果Promise抛出了异常但没有进行捕获，我们可以使用JS自带的 unhandledrejection 事件监听到这些错误。这个事件非常有用，尤其是当我们需要集中做日志收集时，屡试不爽。这个事件只能用于监听 Promise 中的异常，不能用于其他同步代码的异常。

先来看下面这行代码：

复制代码 
const myPromise = new Promise((resolve, reject) => {
  console.log('qianguyihao1');
  reject('not login');
  console.log('qianguyihao2');
})

打印结果：

上面的代码抛出了异常，但没有捕获异常，所以我们可以用 unhandledrejection 事件监听到。代码举例：

复制代码 
// 监听未被捕获的 Promise 异常
window.addEventListener('unhandledrejection', (event) => {
  console.error(`unhandledrejection 监听到异常，写法1: ${event.reason}`)
});

window.onunhandledrejection = event => {
  console.error(`unhandledrejection 监听到异常，写法2: ${event.reason}`);
};

window.onerror = (event) => {
  console.error('onerror 监听到异常:', event);
};


const promise1 = new Promise((resolve, reject) => {
  reject('not login');
})

const promise2 = new Promise((resolve, reject) => {
  throw new Error('network error');
  resolve();
})

打印结果：

可以看到，promise1 和 Promise2 的异常，都被 unhandledrejection 事件收集到了。

代码举例2：

复制代码 
window.addEventListener('unhandledrejection', (event) => {
  console.error(`unhandledrejection 监听到异常: ${event.reason}`)
});

window.onerror = (event) => {
  console.error('onerror 监听到异常:', event);
};

const myPromise = new Promise((resolve, reject) => {
  setTimeout(() => {
    throw new Error('not login');
    resolve();
  }, 100);
})

打印结果：

上面的代码中，unhandledrejection 无法监听异常，因为定时器里的代码属于宏任务。

resolve()之后，再报错无效

代码举例：

复制代码 
const myPromise = new Promise((resolve, reject) => {
  resolve('fulfilled');
  throw new Error("自定义错误");
});

myPromise.then(res => {
  console.log("res", res);
  return res + 1;
}).catch(err => {
  console.log("err：", err);
});

打印结果：

复制代码 
res fulfilled

上方代码中，第3行的异常代码相当于没写。因为 resolve()之后，Promise的状态会立即进入 fulfilled，然后走到 then()，状态不可逆。

async await 的异常处理

捕获异常

代码举例：

复制代码 
function requestData1() {
  return new Promise((resolve, reject) => {
    reject('任务1失败');
  })
}

function requestData2() {
  return new Promise((resolve, reject) => {
    resolve('任务2成功');
  })
}

async function getData() {
  // requestData1 在执行时，遇到异常
  await requestData1();
  /*
  由于上面的代码在执行是遇到异常，所以，这里虽然什么都没写，底层默认写了如下代码：
  return Promise.reject('任务1失败');
  */

  // 下面这两行代码不会再执行了，因为上面的代码遇到了异常
  console.log('qianguyihao1');
  await requestData2();
}

getData();

// 【注意】定时器里的代码会正常实行，因为它在另外一个宏任务里，不在上面的微任务里
setTimeout(() => {
  console.log('qianguyihao2');
}, 100)

打印结果：

所以，为了避免上述问题，我们还需要手动捕获异常。我们捕获到异常之后，这个异常就不会继续网上抛了，更不会抛给浏览器。

高级用法

相关推荐
J总裁的小芒果5 分钟前
Vue3 el-table 默认选中 传入的数组
前端·javascript·elementui·typescript
Lei_zhen967 分钟前
记录一次electron-builder报错ENOENT: no such file or directory, rename xxxx的问题
前端·javascript·electron
辣条小哥哥9 分钟前
electron主进程和渲染进程之间的通信
javascript·electron·ecmascript
咖喱鱼蛋10 分钟前
Electron一些概念理解
前端·javascript·electron
yqcoder11 分钟前
Vue3 + Vite + Electron + TS 项目构建
前端·javascript·vue.js
hzyyyyyyyu15 分钟前
内网安全隧道搭建-ngrok-frp-nps-sapp
服务器·网络·安全
鑫宝Code28 分钟前
【React】React Router：深入理解前端路由的工作原理
前端·react.js·前端框架
Mr_Xuhhh2 小时前
重生之我在学环境变量
linux·运维·服务器·前端·chrome·算法
永乐春秋3 小时前
WEB攻防-通用漏洞&文件上传&js验证&mime&user.ini&语言特性
前端
热门推荐
01(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明02PyTorch机器学习实现液态神经网络03【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总04玄机平台应急响应—webshell查杀05Coze扣子平台完整体验和实践（附国内和国际版对比）06Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO07【目标跟踪】相机运动补偿08Unity中PICO实现 隔空取物 和 接触抓取物体09RAG 实践- Ollama+RagFlow 部署本地知识库10怎样让音频速度变慢？请跟随以下方法进行操作