OpenLayers v7.2.2+TypeScript：forEachFeatureAtPixel参数类型不兼容求助

错误原因 #

forEachFeatureAtPixel 方法的回调函数第一个参数类型是 FeatureLike，它涵盖了 Feature 和 RenderFeature 两种类型。RenderFeature 是OpenLayers用于渲染优化的轻量级对象，缺少 Feature 类的 on、once、un 等事件方法及其他属性，所以直接将参数类型指定为 Feature 会触发类型不兼容错误。

解决方案 #

方案1：类型检查 + 类型收窄（推荐） #

先判断参数是否为 Feature 实例，再执行需要调用 Feature 专属方法的逻辑，这是最安全的方式：

import { Feature } from 'ol';
import { MapBrowserEvent } from 'ol';

function OnMapClick(Event: MapBrowserEvent<UIEvent>) {
  Event.map.forEachFeatureAtPixel(Event.pixel, (currentFeature) => {
    // 检查是否为Feature实例，TypeScript会自动收窄类型
    if (currentFeature instanceof Feature) {
      // 这里可以安全调用Feature的所有方法和属性
      // ...你的业务逻辑代码
    }
  });
}

方案2：类型断言（仅确定不会出现RenderFeature时使用） #

如果你能确保当前场景下只会返回 Feature（比如使用普通VectorLayer，无WebGL渲染等优化），可以使用类型断言强制转换，但这种方式跳过了TypeScript的类型检查，存在运行时风险：

import { Feature } from 'ol';
import { MapBrowserEvent } from 'ol';

function OnMapClick(Event: MapBrowserEvent<UIEvent>) {
  Event.map.forEachFeatureAtPixel(Event.pixel, (currentFeature) => {
    const feature = currentFeature as Feature;
    // ...你的业务逻辑代码
  });
}

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