升级Node与TS编译目标后代码报错，如何用ESLint检测构造函数外this引用？

首先明确问题根源：你的代码中tableNames直接赋值为Map.prototype.keys()的返回值——这是一个一次性迭代器。在ES2019编译目标下，TypeScript会将其转译为数组（比如Array.from(this.result.keys())），因此多次访问tableNames都能获取到值；但切换到ES2022编译目标后，编译结果保留了原生迭代器，当单元测试中多次遍历tableNames时，迭代器耗尽就会导致后续无结果，触发错误。

是否可以编写ESLint规则预警？ #

可以自定义ESLint规则来检测这类问题，核心检测逻辑是识别类实例属性是否直接赋值了Map的keys()/values()/entries()返回的迭代器，这类赋值会导致后续重复访问时数据丢失。

自定义规则的简化示例（基于@typescript-eslint/utils）：

import { Rule } from '@typescript-eslint/utils';

const rule: Rule.RuleModule = {
  meta: {
    messages: {
      avoidIteratorAssignment: '避免直接将Map的迭代器（keys/values/entries）赋值给类实例属性，迭代器仅能遍历一次',
    },
    type: 'problem',
  },
  create(context) {
    return {
      ClassProperty(node) {
        if (node.value?.type === 'CallExpression') {
          const callee = node.value.callee;
          // 检测是否为 this.xxx.keys()/values()/entries() 这类调用
          if (callee.type === 'MemberExpression' 
              && callee.object.type === 'MemberExpression'
              && callee.object.object.type === 'ThisExpression'
              && ['keys', 'values', 'entries'].includes(callee.property.value as string)) {
            context.report({
              node,
              messageId: 'avoidIteratorAssignment',
            });
          }
        }
      },
    };
  },
};

export default rule;

升级前检测问题的其他方法 #

• 提前切换编译目标测试：在Node16环境下，将tsconfig.json的target改为es2022，重新编译并运行单元测试。Node16已支持大部分ES2022特性，能提前暴露迭代器耗尽的问题。
• 修改代码规避风险：直接将迭代器转换为数组，从根源解决问题：

  readonly tableNames: string[] = Array.from(this.result.keys());
  

  数组支持多次遍历，不受环境和编译目标影响。
• 增强单元测试覆盖：添加对tableNames多次遍历的测试用例，比如连续两次遍历并验证结果一致，提前发现迭代器的一次性特性问题。
• 启用TypeScript严格模式：开启tsconfig.json中的strict: true，尤其是strictPropertyInitialization，虽然不能直接检测迭代器问题，但能减少其他隐式类型错误，提升代码健壮性。

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