在 javascript 中实现 promise 链中的错误转换,核心做法是在 .catch() 或 .then(null, ...) 的回调函数中抛出新的 error 对象。这样可以将底层的具体异常(如网络超时、数据解析失败)转换为业务层面的统一错误类型,确保调用者能捕获到标准化的错误信息。

如何捕获并转换特定类型的错误
要实现针对特定错误的转换,需要在 .catch() 回调中检查 error.name 或 error.message。例如,当 fetch 请求返回非 200 状态码时,通常会抛出一个自定义的 HttpError。我们可以在这里将其转换为一个更通用的 ApiError,以便上层逻辑统一处理。

class HttpError extends Error {
constructor(status, message) {
super(message);
this.name = 'HttpError';
this.status = status;
}
}
function fetchUser(id) {
return fetch(`/api/users/${id}`)
.then(res => {
if (!res.ok) throw new HttpError(res.status, `HTTP ${res.status}`);
return res.json();
})
.catch(err => {
if (err.name === 'HttpError') {
// 将 HTTP 错误转换为统一的 API 错误
throw new Error(`API Failure: ${err.message}`);
}
// 其他错误原样抛出
throw err;
});
}
// 预期结果:
// 如果 fetch 返回 404,最终 catch 捕获到的错误 message 为 "API Failure: HTTP 404"
// 如果 fetch 返回 200,则成功解析 JSON
如何在链式调用中保持错误上下文
在复杂的异步流程中,直接抛出新错误会丢失原始堆栈。为了保留调试信息,通常会将原始错误作为 cause 属性传递给新的 Error 对象。这种做法利用了 ES2022 引入的 Error Cause 特性,使得错误转换后的堆栈追踪依然完整,方便定位问题根源。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

async function processOrder(orderId) {
try {
const order = await getOrder(orderId);
const payment = await processPayment(order.total);
return { success: true, data: payment };
} catch (originalError) {
// 使用 cause 保留原始错误堆栈
throw new Error('Order processing failed', { cause: originalError });
}
}
// 预期结果:
// 外层 catch 捕获到的错误 message 为 "Order processing failed"
// error.cause 指向原始的 getOrder 或 processPayment 错误
// 打印 error.stack 会包含两层堆栈信息
基于未捕获异常的默认行为处理
当 Promise 链中没有显式的 .catch() 时,未处理的拒绝会被静默吞掉(在 Node.js 中可能触发 unhandledRejection 事件)。为了确保所有路径都有明确的错误转换,最佳实践是在链的末尾始终附加一个 .catch()。这个最终的 .catch() 负责将所有未被前序逻辑转换的错误,统一记录日志或转换为标准的用户友好提示。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










