TypeScript Academy · 课时

带类型的错误类与层次结构

Q: 「带类型的错误类与层次结构」这节课中我会学到什么？

使用可辨识类型创建自定义错误类 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用可辨识类型创建自定义错误类

第 1 / 4 课13 个步骤

带类型的错误类与层次结构 是 CoddyKit 上的免费 TypeScript Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。

欢迎

TypeScript 中的自定义错误类为错误提供类型层次结构，以便进行安全、结构化的处理。

扩展 Error

创建带有 statusCode 的基础 AppError 类。

class AppError extends Error {
  constructor(public message: string, public statusCode = 500) {
    super(message);
    this.name = 'AppError';
  }
}

错误层次结构

为特定错误类型构建带类型的子类。

class NotFoundError extends AppError {
  constructor(resource: string) { super(`${resource} not found`, 404); }
}
class ValidationError extends AppError {
  constructor(public fields: string[]) { super('Validation failed', 400); }
}

使用 instanceof

在 catch 代码块中使用 instanceof 缩小错误类型范围。

try { doSomething(); }
catch (err) {
  if (err instanceof NotFoundError) res.status(404).json({ error: err.message });
  else if (err instanceof ValidationError) res.status(400).json({ fields: err.fields });
}

可辨识错误联合类型

使用可辨识联合类型处理带类型的错误。

type AppError =
  | { kind: 'not_found'; resource: string }
  | { kind: 'unauthorized' }
  | { kind: 'validation'; fields: string[] };

错误工厂函数

为每种错误类型创建工厂函数。

const errors = {
  notFound: (r: string) => new NotFoundError(r),
  unauthorized: () => new AppError('Unauthorized', 401),
};

错误序列化

为 API 响应序列化错误。

function serializeError(err: AppError): Record<string, unknown> {
  return { error: err.message, code: err.statusCode, name: err.name };
}

设置 this.name

始终将 this.name 设置为错误类名称，以便在日志中正确识别错误。

class MyError extends Error {
  readonly name = 'MyError' as const;
  constructor(msg: string) { super(msg); }
}

Express 中的错误

在 Express 错误处理程序中使用带类型的自定义错误。

app.use((err: unknown, req: Request, res: Response, next: NextFunction) => {
  if (err instanceof AppError) {
    res.status(err.statusCode).json({ error: err.message });
  } else {
    res.status(500).json({ error: 'Internal error' });
  }
});

错误日志记录模式

记录错误的类型和消息，以便进行可观测性分析。

function logError(err: unknown): void {
  if (err instanceof Error) console.error(`[${err.name}] ${err.message}`);
  else console.error('Unknown error:', err);
}

测试错误类型

测试函数是否抛出了正确的错误类型。

test('throws NotFoundError for missing user', async () => {
  await expect(getUser(999)).rejects.toThrow(NotFoundError);
});

快速检查

TypeScript 中哪个关键字会在运行时检查对象是否为某个类的实例？

在交互式课程中回答

回顾

带类型的错误类和层次结构：您已经学习了本主题的关键概念，以及如何在实际 TypeScript 项目中应用这些概念。

免费开始

用 AI 导师学习 TypeScript — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 101
课程: 352

免费开始学习查看完整课程

常见问题解答

「带类型的错误类与层次结构」课时是免费的吗？

是的 — 「带类型的错误类与层次结构」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。

「带类型的错误类与层次结构」这节课中我会学到什么？

使用可辨识类型创建自定义错误类你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「带类型的错误类与层次结构」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 TypeScript Academy