Home > @esengine/ecs-framework-monorepo > QuerySystem > queryByComponent

QuerySystem.queryByComponent() method

按单个组件类型查询实体

返回包含指定组件类型的所有实体。 这是最基础的查询方法，具有最高的查询性能。

Signature:

queryByComponent<T extends Component>(componentType: ComponentType<T>): QueryResult;

Parameters

Parameter	Type	Description
componentType	ComponentType<T>	要查询的组件类型

Returns:

QueryResult

查询结果，包含匹配的实体和性能信息

Example

// 查询所有具有位置组件的实体
const entitiesWithPosition = querySystem.queryByComponent(PositionComponent);