async函数是JavaScript中处理异步操作的重要语法，它的返回值类型和普通函数有明显区别，理解其返回值规则能帮助开发者更准确地处理异步逻辑。普通函数调用后返回的是函数体内return语句指定的值，而async函数的返回值始终会被包裹成Promise对象，这是其核心特性之一。
async函数返回值的基本规则
无论async函数体内返回什么类型的值，最终调用该函数得到的返回值都是Promise实例，具体表现分为以下几种情况：
- 如果函数体内没有return语句，默认返回
Promise.resolve(undefined) - 如果函数体内return了一个非Promise类型的值，返回值是
Promise.resolve(该值) - 如果函数体内return了一个Promise实例，返回值就是该Promise实例本身
- 如果函数体内抛出错误，返回值是
Promise.reject(错误对象)
不同场景的返回值示例
返回基本类型值
当async函数返回数字、字符串、布尔值等基本类型时，返回值会被包装为 fulfilled 状态的Promise：
async function getNumber() {
return 123;
}
const result = getNumber();
console.log(result instanceof Promise); // true
result.then(value => {
console.log(value); // 123
});
返回Promise对象
如果async函数直接返回一个Promise，那么函数的返回值就是这个Promise，不会做额外的包装：
async function getPromise() {
return new Promise((resolve) => {
setTimeout(() => {
resolve('延迟返回的结果');
}, 1000);
});
}
getPromise().then(value => {
console.log(value); // 延迟返回的结果
});
函数抛出错误的情况
async函数内部抛出错误时，返回值会变成 rejected 状态的Promise：
async function throwError() {
throw new Error('函数执行出错');
}
throwError().catch(error => {
console.log(error.message); // 函数执行出错
});
和普通函数的返回值对比
我们可以通过表格更清晰地看到两者的差异：
| 对比项 | 普通函数 | async函数 |
|---|---|---|
| 无return时的返回值 | undefined | Promise.resolve(undefined) |
| return基本类型时的返回值 | 对应的基本类型值 | 包裹该值的Promise实例 |
| 内部抛出错误时的表现 | 直接抛出错误，中断后续执行 | 返回rejected状态的Promise，不会中断外部执行 |
实际开发中的注意事项
在使用async函数时，需要注意不能把它的返回值当成普通值直接使用，必须通过then方法或者await关键字来获取实际的结果：
async function getData() {
return '数据结果';
}
// 错误用法：直接拿返回值当字符串用
const data1 = getData();
console.log(data1.length); // 报错，因为data1是Promise，没有length属性
// 正确用法1：使用then
getData().then(data => {
console.log(data.length); // 4
});
// 正确用法2：使用await（需要在async函数内部）
async function handleData() {
const data2 = await getData();
console.log(data2.length); // 4
}
handleData();
另外如果async函数返回的Promise是rejected状态，一定要记得捕获错误，否则会导致未处理的Promise拒绝警告，影响程序的稳定性。
async函数返回值类型PromiseJavaScript异步编程修改时间：2026-06-20 06:18:23