SuperAgent endAsync语义疑问：语法糖与方法命名是否存在矛盾？

首先得说，你的这个观察挺敏锐的——endAsync()这个名字确实容易让人误解成“会阻塞等待Promise完成”，但实际上它只是返回一个代表异步HTTP请求操作的Promise对象，并不会主动等待。这其实是命名习惯和语义理解上的小偏差，咱们拆解来看：

1. 先回顾SuperAgent的传统回调模式 #

在没有Promise包装的时候，SuperAgent用的是end()方法接受回调：

request.get('/location').end(function(err, response) {
  if (err) {
    console.dir(err);
  } else {
    console.log("Got " + response.text);
  }
});

2. endAsync()的定位：回调转Promise的包装器 #

superagent-as-promised这个库做的事情，就是给SuperAgent的请求对象加了endAsync()方法——它本质上是把end()的回调模式包装成了Promise返回，而不是“执行等待”。这个命名里的Async后缀，更多是为了和传统的end()方法做区分，表明这是异步操作的Promise版本，而不是说它会主动等待Promise settle（那是await关键字该做的事）。

3. 为什么名字会有误导性？ #

确实，后来的JS生态里，Async后缀更多和async函数关联，但在这个库诞生的时期（Promise还没成为ES标准特性的时候），很多库会用Async后缀来命名“返回Promise的异步方法”，用来和回调式方法做区分。比如早期的一些Node.js工具库，就有类似的命名习惯。

所以本质上，endAsync()的语义是：启动异步请求，并返回一个可以跟踪请求结果的Promise，而不是“等待请求完成”。你提到的then/catch写法是它的语法糖，本质上就是直接用endAsync()拿到Promise后链式调用，两者完全等价。

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