VS Code中Promise.all结合await出现“await无作用”警告的问题排查

问题背景 #

在VS Code 1.70.1、Node.js 16环境下，一段实现异步任务负载均衡的JS代码出现了异常警告：

• 当任务函数直接返回单个Promise时，代码无警告；
• 当任务函数返回Promise.all([p])的Promise时，await tasks.reduce(...)处会触发"await has no effect on the type of this expression"警告；
• 代码实际功能正常，会等待所有任务执行完成，但将代码放到HTML的<script>标签或TS文件中时，VS Code不会生成该警告。

复现代码 #

// nodejs 16 test function. VSCode 1.70.1 IDE
async function jobExecutorMinified() {
  const generateTask = () => {
    return () => {

      const p = new Promise(resolve =>  {
        setTimeout(() => {
          resolve();
        }, 5000);
      });

      // returning the promise of Promise.all -> warning w1
      return Promise.all([p]);

      // returning the promise directly -> no warnings
      // return p;

    }
  }
  const tasks = [generateTask()];

  /*w1*/await tasks.reduce((prevTask, currTask) => {
    return prevTask.then(() => {
      return currTask();
    });
  }, Promise.resolve());

  console.log('task chunking is ready');
}


jobExecutorMinified().then(() => {
  console.log('job executor minified returned');
});

核心分析思路 #

1. VS Code内置TS语言服务的类型推断偏差 #

VS Code对JS文件的代码提示和警告依赖TypeScript语言服务（TS Server）。当任务返回Promise.all([p])时，其类型是Promise<void[]>，而直接返回单个Promise的类型是Promise<void>。TS Server在跟踪reduce生成的Promise链时，可能出现了类型推断中断：

• 对于Promise<void>，TS Server能准确识别reduce最终返回Promise<void>，明确await的作用；
• 对于Promise<void[]>，TS Server可能错误判断reduce的返回类型不是Promise，或者认为await不会改变结果类型，从而触发警告。

验证方式：手动给reduce的返回值添加类型注释，看警告是否消失：

/** @type {Promise<void>} */
const taskChain = tasks.reduce((prevTask, currTask) => {
  return prevTask.then(() => currTask());
}, Promise.resolve());

await taskChain;

2. VS Code 1.70.1版本的TS Server特定Bug #

该警告仅出现在VS Code 1.70.1中，后续版本的TS Server可能修复了这个类型推断的问题。

验证方式：将VS Code升级到最新稳定版，重新打开JS文件，查看警告是否消失。

3. JS文件与HTML/TS文件的检查规则差异 #

VS Code对不同场景下的代码检查规则不同：

• JS文件默认可能启用了更严格的类型检查（受jsconfig.json或工作区设置影响）；
• HTML中的<script>标签默认使用宽松的检查规则，TS文件则依靠明确的类型系统，能更准确处理Promise.all的返回类型。

验证方式：查看当前工作区的jsconfig.json，尝试调整compilerOptions中的配置，比如关闭strict或checkJs，观察警告变化。

4. Promise链的类型跟踪边界问题 #

在reduce的回调中，prevTask.then(() => currTask())的链结构中，当currTask()返回Promise<void[]>时，TS Server可能无法正确穿透整个链的类型，导致对最终返回值的类型判断错误。

验证方式：将currTask()的返回值显式转换为Promise<void>，消除类型差异：

await tasks.reduce((prevTask, currTask) => {
  return prevTask.then(() => {
    // 将Promise<void[]>转为Promise<void>
    return currTask().then(() => {});
  });
}, Promise.resolve());

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