React Native TypeScript下setTimeout正确类型配置及相关疑问

1. 修复setTimeout返回类型错误 #

该类型识别错误的核心原因是TypeScript错误加载了Node.js环境的全局类型声明，只需调整tsconfig.json的compilerOptions配置即可解决：

• 新增types字段，显式声明只加载react-native相关类型，阻断隐式引入的Node.js类型声明：

"types": ["react-native"]

• 检查项目是否安装了冗余的@types/node依赖，如果有直接卸载即可，monorepo项目需要额外排查根目录是否安装了该依赖。

你之前使用的临时写法是符合类型推导规则的合理写法，调整配置后可以直接声明let timeout: number，React Native环境下的setTimeout返回值就是数字类型的定时器ID，和浏览器环境行为一致。

2. 相关疑问解答 #

• React Native的运行环境类型定义全部内置在@types/react-native包中，无需额外安装其他类型包，全局API的类型声明可以在项目的node_modules/@types/react-native/globals.d.ts文件中查看，包含定时器、console等所有全局对象的类型定义。
• 非Hermes引擎的React Native JS运行环境官方名称是JavaScriptCore，这是React Native默认搭载的JS引擎，和iOS系统内置的Safari浏览器使用的是同一款引擎的定制版本，安卓端默认环境也是独立打包的JavaScriptCore引擎。
• 无论使用Hermes还是JavaScriptCore，公用的全局API类型定义都统一在@types/react-native包中，没有单独的JavaScriptCore专属类型包，只要保证安装的@types/react-native版本和项目中的react-native版本匹配即可。

调整后的完整tsconfig参考 #

原配置仅需新增types字段即可，修改后核心配置如下：

{
  "compilerOptions": {
    "target": "esnext",
    "module": "commonjs",
    "lib": ["es2017"],
    "allowJs": true,
    "jsx": "react-native",
    "noEmit": true,
    "isolatedModules": true,
    "strict": true,
    "moduleResolution": "node",
    "allowSyntheticDefaultImports": true,
    "esModuleInterop": true,
    "skipLibCheck": false,
    "resolveJsonModule": true,
    "types": ["react-native"]
  },
  "exclude": [
    "node_modules", "babel.config.js", "metro.config.js", "jest.config.js"
  ]
}

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