Method first

packages/core/src/ECS/Core/Query/CompiledQuery.ts:235–253

* 获取第一个匹配的实体及其组件 * * Get first matching entity with its components. * * @returns 实体和组件元组，或 null | Entity and components tuple, or null

()

     * @returns 实体和组件元组，或 null | Entity and components tuple, or null
     */
    public first(): [Entity, ...InstanceTypes<T>] | null {
        const entities = this.entities;
        if (entities.length === 0) {
            return null;
        }

        const entity = entities[0]!;
        const components: Component[] = [];

        for (const type of this._componentTypes) {
            const component = entity.getComponent(type);
            if (!component) {
                return null;
            }
            components.push(component);
        }

        return [entity, ...(components as InstanceTypes<T>)];
    }

    /**
     * 转换为数组