TypeScript方法声明中有无async关键字的功能差异探究

当TypeScript函数声明返回Promise类型时，使用async关键字和不使用的函数存在以下核心功能差异：

• 自动包装返回值
  async函数会自动将任何返回值（包括非Promise类型）包装为Promise实例。比如直接return字符串，async会帮你调用Promise.resolve()转换；而普通函数必须手动返回Promise实例，否则会触发类型错误：

  async function autoWrap(): Promise<string> {
    return "自动包装成Promise"; // 等价于return Promise.resolve("自动包装成Promise")
  }
  
  function manualWrap(): Promise<string> {
    return "直接返回字符串会报错"; // TypeScript类型检查失败：类型"string"不能赋值给类型"Promise<string>"
  }
  

• 同步错误的自动捕获
  async函数内部的同步错误会被自动捕获，并转为rejected状态的Promise；而普通函数里的同步错误会直接抛出，无法通过Promise的.catch()捕获，必须用try/catch包裹函数调用：

  async function asyncError(): Promise<string> {
    throw new Error("同步错误"); // 自动转为Promise.reject(new Error("同步错误"))
  }
  
  function normalError(): Promise<string> {
    throw new Error("同步错误"); // 直接抛出错误，不会进入Promise链
  }
  
  // 调用测试
  asyncError().catch(err => console.log(err.message)); // 能正常捕获错误
  // normalError().catch(...) 不会执行，需要用try/catch包裹：
  try {
    normalError();
  } catch (err) {
    console.log((err as Error).message);
  }
  

• 支持await关键字
  只有在async函数内部才能使用await关键字来等待Promise完成，普通函数中使用await会直接触发语法错误：

  async function useAwait(): Promise<string> {
    const data = await Promise.resolve("等待异步结果"); // 合法
    return data;
  }
  
  function noAwait(): Promise<string> {
    const data = await Promise.resolve("等待异步结果"); // 语法错误：await只能在async函数中使用
    return data;
  }
  

• 运行时函数类型差异
  从运行时角度看，async函数属于AsyncFunction类型，而普通返回Promise的函数是常规Function类型：

  console.log(autoWrap instanceof AsyncFunction); // true
  console.log(manualWrap instanceof AsyncFunction); // false
  

  不过这个差异在多数业务场景中影响不大，主要是函数对象本身的类型区别。

内容的提问来源于stack exchange，提问作者Zigzagoon