JavaScript / TypeScript / 系统课时

主动抛出错误

主动抛出错误

本篇解决程序中“发现异常输入后如何主动停止错误流程”的问题。你将学习如何使用 throw 创建错误、如何设计 Error 信息,并把参数校验融入实际函数开发中。

学习目标

  • 理解 throw 与 Error 对象在 JavaScript 异常处理中的作用
  • 掌握参数校验中主动抛出错误的实现方式
  • 学会设计更容易定位问题的错误信息

为什么需要主动抛出错误

JavaScript 运行过程中有很多错误并不会自动触发异常。例如,一个函数要求接收用户编号,但调用方传入了空字符串。如果继续执行,程序可能在更深层的位置才失败,导致排查成本增加。

主动抛出错误可以让函数在发现不满足条件时立即终止,并把问题原因明确传递给调用方。它通常用于参数校验、业务规则检查和状态保护。

throw 关键字用于抛出异常对象。被抛出的值会沿着调用栈向上传递,直到被 try...catch 捕获,或者导致程序停止执行。

使用 Error 创建异常对象

虽然 JavaScript 可以抛出任意值,但工程代码中通常应该抛出 Error 或其子类实例,因为它包含标准错误信息和调用栈,方便定位问题。

js
function getUserName(user) {
  if (!user) {
    throw new Error("用户对象不能为空");
  }

  return user.name;
}

try {
  getUserName(null);
} catch (error) {
  console.log(error.message);
}

预期输出

text
用户对象不能为空

这里函数先检查输入条件,发现无法继续执行后立即抛出错误。调用方通过 catch 获取错误对象,并根据场景决定记录日志、提示用户或继续处理。

在参数校验中设计错误信息

好的错误信息应该说明三个内容:哪里出错、为什么出错、期望是什么。例如,不推荐只写“参数错误”,因为调用者无法判断具体问题。

js
function createAccount(name, age) {
  if (typeof name !== "string" || name.trim() === "") {
    throw new Error("创建账号失败:name 必须是非空字符串");
  }

  if (!Number.isInteger(age) || age < 18) {
    throw new Error("创建账号失败:age 必须是不小于 18 的整数");
  }

  return { name, age };
}

createAccount("", 16);

预期结果

text
抛出 Error:创建账号失败:name 必须是非空字符串

在实际项目中,参数校验通常放在函数入口处。这样可以保证后续逻辑运行时,输入已经满足基本要求。

throw 与 return 的使用区别

return 表示函数正常结束并返回结果,而 throw 表示当前流程无法继续,需要交给上层处理。

场景 推荐方式
查询不到数据且允许没有结果 return 默认值或空结果
参数格式明显错误 throw Error
业务规则不允许继续执行 throw Error

不要把所有异常情况都设计成错误。只有调用方无法正常继续处理时,才适合使用主动抛错。

常见错误设计问题

开发中常见的问题包括直接抛字符串、错误信息过于模糊,以及在底层函数重复包装同一个错误。

js
throw "失败";

这种写法缺少标准错误对象信息,不利于调试。更推荐:

js
throw new Error("文件路径不能为空");

主动抛出错误的核心价值不是让程序更容易失败,而是在错误发生的位置提供准确上下文,让问题能够快速被发现和处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

主动抛出错误

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通