Typescript中如何解决ESLint报Geolocation相关接口未定义的问题

该警告是TypeScript类型检测触发的，不影响运行是因为浏览器原生支持Geolocation API，报错是因为项目未引入浏览器DOM API对应的类型定义，TS无法识别原生GeolocationPosition类型。

方案1：修改tsconfig引入DOM类型（最推荐） #

在项目根目录的tsconfig.json中，找到compilerOptions下的lib配置项，添加"DOM"即可，示例配置：

{
  "compilerOptions": {
    "lib": ["ESNext", "DOM"],
    // 其余原有配置保持不变
  }
}

修改后重启IDE或TS服务，警告就会消失。

方案2：手动全局声明类型（适用于方案1无效的特殊场景） #

如果修改tsconfig后仍有警告，可在项目的全局类型声明文件（后缀为.d.ts，常见为typings.d.ts、src/vite-env.d.ts等）中添加以下类型定义：

declare interface GeolocationPosition {
  coords: {
    latitude: number;
    longitude: number;
    altitude: number | null;
    accuracy: number;
    altitudeAccuracy: number | null;
    heading: number | null;
    speed: number | null;
  };
  timestamp: number;
}

方案3：临时忽略检测（不建议长期使用） #

如果需要快速消除当前行的警告，可在使用GeolocationPosition的代码行上方添加注释// @ts-ignore，跳过当前行的类型检测：

// @ts-ignore
export function getUserPosition(callback : (position : GeolocationPosition) => void) {
  // 原有逻辑
}

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