使用 promise.reject() 静态方法可以立即返回一个处于拒绝状态的 promise。调用该方法时传入具体的错误对象或信息，即可在代码中手动触发失败流程，通常配合 async/await 的 try...catch 结构或直接链式调用 .catch() 来处理异常。
如何手动抛出并捕获 Promise 拒绝状态
通过 Promise.reject(new Error('message')) 创建实例后，可以使用 await 等待它，此时会直接抛出异常进入 catch 块；或者使用 .then().catch() 链式处理。以下是一个完整的示例程序，展示了两种处理方式。
const manualReject = () => {
return new Promise((resolve, reject) => {
// 模拟异步操作后立即拒绝
setTimeout(() => {
reject(new Error('手动触发的失败'));
}, 0);
});
};
// 方式一：使用 async/await
async function handleWithAwait() {
try {
await manualReject();
} catch (error) {
console.log('Catch block:', error.message); // 输出: Catch block: 手动触发的失败
}
}
// 方式二：使用 .catch()
manualReject()
.then(result => console.log('Success', result))
.catch(error => console.log('Catch block:', error.message)); // 输出: Catch block: 手动触发的失败
handleWithAwait();
预期结果：控制台打印两次 "Catch block: 手动触发的失败"，证明无论哪种方式都能正确捕获由 reject 触发的失败状态。
Promise.reject 与 throw 的区别是什么
Promise.reject() 是同步返回一个已拒绝的 Promise 对象，而 throw 是在函数执行流中抛出异常。在 async 函数内部，throw 会自动被包装成 Promise.reject()。因此，在普通函数中需要显式返回 Promise.reject()，而在 async 函数中直接使用 throw 更符合语义且能自动处理返回值。
// 普通函数必须返回 Promise.reject
function normalFunc() {
return Promise.reject(new Error('Normal Reject'));
}
// async 函数中 throw 等价于返回 Promise.reject
async function asyncFunc() {
throw new Error('Async Throw');
}
// 验证两者行为一致
normalFunc().catch(e => console.log('Normal:', e.message));
asyncFunc().catch(e => console.log('Async:', e.message));
预期结果：控制台分别打印 "Normal: Normal Reject" 和 "Async: Async Throw"，表明两者在异步上下文中效果一致。
如果传入非 Error 对象会发生什么
Promise.reject() 接受任何类型的值作为拒绝原因。如果传入字符串、数字或非 Error 对象，它们将原样传递给 .catch() 或 catch 块的参数。虽然推荐始终使用 Error 对象以保留堆栈跟踪，但技术上允许传入任意值。
Promise.reject('Just a string')
.catch(reason => console.log('Reason type:', typeof reason, 'Value:', reason));
Promise.reject(404)
.catch(reason => console.log('Reason type:', typeof reason, 'Value:', reason));
预期结果：第一行打印 "Reason type: string Value: Just a string"，第二行打印 "Reason type: number Value: 404"。这验证了 Promise.reject() 不会强制转换输入类型，而是直接将其作为拒绝理由传递。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
