Jest运行Airtable测试报Cannot read property 'bind' of undefined如何解决

• 最核心的诱因是Jest默认测试环境不匹配：Jest 27及以上版本默认使用jsdom作为测试环境，该环境模拟浏览器运行时，没有完整实现Node.js的原生内置API（如http、https、querystring等模块）。Airtable SDK是为Node.js环境开发的，内部会调用这些Node专属API并使用bind绑定方法执行上下文，当API在jsdom环境下为undefined时，就会抛出Cannot read property 'bind' of undefined的错误。
• ts-node运行时是纯Node.js环境，所有依赖的原生API都存在，因此运行正常。
• 其他可能的次要原因：
  • Jest开启了自动mock（automock: true），自动生成的Airtable mock对象缺失原SDK的内部方法，调用时触发报错。
  • TypeScript配置中esModuleInterop、allowSyntheticDefaultImports未开启，导致Airtable默认导入解析异常，构造函数为undefined。

• 优先修改Jest测试环境为Node：在jest.config.js（或jest配置文件）中添加配置项testEnvironment: 'node'，后端业务逻辑测试直接使用Node环境即可，无需模拟浏览器环境。
• 若必须使用jsdom环境，可在Jest配置中添加缺失的Node模块polyfill，或配置moduleNameMapper映射缺失的内置模块到对应polyfill包。
• 若开启了自动mock，在测试文件顶部添加jest.unmock('airtable')，或在Jest配置中将airtable加入unmockedModulePathPatterns列表。
• 检查tsconfig.json，确保compilerOptions下的esModuleInterop、allowSyntheticDefaultImports均设为true，保证ES模块默认导入逻辑正常。

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