Promise 错误捕获：同步异常与异步 Promise 拒绝-js教程-PHP中文网

Promise 错误捕获：同步异常与异步 Promise 拒绝

碧海醫心

发布： 2025-09-24 19:52:01

原创

807人浏览过

promise 错误捕获：同步异常与异步 promise 拒绝

Promise 错误捕获中，同步函数抛出错误时，.catch 块未能捕获该错误。我们将深入探讨 Promise 如何处理错误，区分同步异常和异步 Promise 拒绝，并提供最佳实践，确保你的代码能够有效地处理各种错误场景。

理解 Promise 中的错误处理

在 JavaScript 中，错误处理有两种主要方式：try...catch 语句用于捕获同步代码中的异常，而 Promise 的 .then() 和 .catch() 方法用于处理异步操作的结果，包括成功和失败（拒绝）。

问题在于，当一个函数（比如 DeleteProject）同步地抛出一个错误时，Promise 的 .catch() 块不会自动捕获这个错误。这是因为该函数不是 async 函数，或者在 Promise 构造函数或 Promise.then/catch 的回调函数中抛出的错误。

区分同步异常和异步 Promise 拒绝

理解这一点至关重要。以下是 Promise 机制将 throw 抛出的错误转换为 rejected Promise 的几种情况：

new Promise 构造函数中： 在 new Promise 的 executor 函数中抛出的任何错误都会导致 Promise 被拒绝。
Promise.then 或 Promise.catch 的回调函数中： 在 .then() 或 .catch() 方法的回调函数中抛出的错误会导致后续的 Promise 被拒绝。
async 函数中： async 函数会隐式地返回一个 Promise。如果在 async 函数中抛出错误，该 Promise 将会被拒绝。

示例：

// 情况 1：new Promise 构造函数
const myPromise = new Promise((resolve, reject) => {
  try {
    // 可能会抛出错误的代码
    throw new Error("Error in Promise constructor");
    resolve("Success"); // 这行代码不会被执行
  } catch (error) {
    reject(error);
  }
});

myPromise.catch(error => {
  console.error("Caught error:", error.message); // 输出: Caught error: Error in Promise constructor
});

// 情况 2：Promise.then 的回调函数
Promise.resolve(1)
  .then(() => {
    throw new Error("Error in .then");
  })
  .catch(error => {
    console.error("Caught error:", error.message); // 输出: Caught error: Error in .then
  });

// 情况 3：async 函数
async function myFunction() {
  throw new Error("Error in async function");
}

myFunction().catch(error => {
  console.error("Caught error:", error.message); // 输出: Caught error: Error in async function
});

登录后复制

解决方案：将同步异常转换为 Promise 拒绝

为了让 .catch() 块能够捕获 DeleteProject 函数中抛出的错误，你需要显式地将其转换为一个 rejected Promise。

方法一：使用 Promise.reject()

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

查看详情

这是推荐的做法，因为它确保所有的错误都通过 Promise 机制处理，使得代码更加一致。

function DeleteProject(id: string, customerId: string): Promise<void> {
    return Promise.reject(new Error('test error'));
}

projectService.DeleteProject(state.FocusedProject.ID, state.FocusedProject.CustomerID)
    .then(() => {
        // ...stuff when it works...
    })
    .catch(error => {
        console.log('caught you');
        HandleError(error, 'Delete Project');
    });

登录后复制

方法二：使用 try...catch 包裹同步代码

如果你必须处理同步异常，可以使用 try...catch 语句，然后将其转换为 rejected Promise。

function DeleteProject(id: string, customerId: string): Promise<void> {
  try {
    throw new Error('test error');
  } catch (error) {
    return Promise.reject(error);
  }
}

projectService.DeleteProject(state.FocusedProject.ID, state.FocusedProject.CustomerID)
    .then(() => {
        // ...stuff when it works...
    })
    .catch(error => {
        console.log('caught you');
        HandleError(error, 'Delete Project');
    });

登录后复制

最佳实践与注意事项

保持错误处理一致性： 尽量避免混合使用同步异常和异步 Promise 拒绝。选择一种方式（推荐使用 Promise.reject()）并坚持使用它，以提高代码的可读性和可维护性。
明确区分错误类型： 如果你的函数需要处理不同类型的错误（例如，同步的输入验证错误和异步的服务器通信错误），可以考虑使用不同的 Error 子类来区分它们。但是，即使如此，也最好将所有错误都转换为 rejected Promise。
记录错误类型： 如果你的函数可能抛出同步异常，请在文档中明确说明，以便调用者能够正确地处理这些异常。
使用 async/await： async/await 语法可以使异步代码看起来更像同步代码，从而简化错误处理。你可以使用 try...catch 语句来捕获 async 函数中抛出的错误。

示例：使用 async/await

async function myAsyncFunction() {
  try {
    // 可能会抛出错误的代码
    const result = await someAsyncOperation();
    return result;
  } catch (error) {
    console.error("Caught error:", error.message);
    throw error; // 重新抛出错误，以便调用者可以处理它
  }
}

myAsyncFunction()
  .then(result => {
    console.log("Result:", result);
  })
  .catch(error => {
    console.error("Error in main:", error.message);
  });

登录后复制

总结

理解 Promise 如何处理错误，特别是区分同步异常和异步 Promise 拒绝，是编写健壮的 JavaScript 代码的关键。通过将同步异常转换为 rejected Promise，你可以确保所有的错误都通过 Promise 机制处理，从而简化错误处理逻辑并提高代码的可维护性。选择一种错误处理方式并坚持使用它，明确区分错误类型，并使用 async/await 语法来简化异步代码，这些都是编写高质量 Promise 代码的最佳实践。

以上就是Promise 错误捕获：同步异常与异步 Promise 拒绝的详细内容，更多请关注php中文网其它相关文章！