如何将for-await-of异步循环改写为ESLint支持的数组迭代实现

规则适配方向 #

触发no-restricted-syntax报错的两个核心约束需要同时满足：

• 不在业务代码中直接使用迭代器/生成器语法，避免引入体积过重的regenerator-runtime依赖
• 优先使用数组原生迭代方法完成逻辑，减少手写循环的使用

针对请求流（Node.js Readable流、Web Fetch响应体等异步可读取对象），无需自行编写遍历逻辑，直接利用流原生的异步收集能力拿到全量分片数组，再通过数组迭代方法完成payload拼接即可。

合规改写代码 #

所有遍历逻辑由流的内置API封装完成，业务层无手写循环：

async function getPayload(body) {
  // 调用流原生toArray方法：自动遍历收集所有chunk为数组，无业务层手写循环
  const chunks = await body.toArray();
  // 可选择数组原生迭代方法完成payload拼接，以下为reduce实现示例
  const payload = chunks.reduce((pre, cur) => pre + cur, "");
  return payload;
}

如果更习惯forEach的写法，拿到chunks数组后可以替换为等价实现，同样符合规范：

async function getPayload(body) {
  const chunks = await body.toArray();
  let payload = "";
  chunks.forEach(chunk => {
    payload += chunk;
  });
  return payload;
}

合规性验证 #

• 全程未使用for await...of语法，不会触发迭代器/生成器相关的no-restricted-syntax校验报错，也不需要额外引入regenerator-runtime运行时依赖
• 遍历流读取分片的逻辑由流的内置API实现，业务代码层面没有手写循环结构
• payload拼接环节可自由选择数组原生forEach()、reduce()、map()等迭代方法实现，完全符合代码规范对数组迭代方式的优先要求，无规则冲突

常见注意事项 #

• 不要直接对原始的流对象调用同步版forEach()、map()方法，这类同步API无法匹配流的异步读取特性，会导致内容读取不完整
• 虽然流自身提供的forEach()支持异步遍历，但需要在外部作用域维护拼接变量，容易产生竞态问题，不如先收集为数组再做迭代的写法稳定性和可读性更强

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