363 lines
13 KiB
TypeScript
363 lines
13 KiB
TypeScript
|
/**
|
|||
|
|
* Matcher完整测试套件
|
|||
|
|
* 包含功能测试、性能测试和向后兼容性测试
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
import { Scene } from '../../../src/ECS/Scene';
|
|||
|
|
import { Entity } from '../../../src/ECS/Entity';
|
|||
|
|
import { Component } from '../../../src/ECS/Component';
|
|||
|
|
import { Matcher } from '../../../src/ECS/Utils/Matcher';
|
|||
|
|
|
|||
|
|
// 测试组件
|
|||
|
|
class Position extends Component {
|
|||
|
|
constructor(public x: number = 0, public y: number = 0) {
|
|||
|
|
super();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
class Velocity extends Component {
|
|||
|
|
constructor(public vx: number = 0, public vy: number = 0) {
|
|||
|
|
super();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
class Health extends Component {
|
|||
|
|
constructor(public hp: number = 100) {
|
|||
|
|
super();
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
class Dead extends Component {}
|
|||
|
|
|
|||
|
|
describe('Matcher测试套件', () => {
|
|||
|
|
let scene: Scene;
|
|||
|
|
let entities: Entity[];
|
|||
|
|
|
|||
|
|
beforeEach(() => {
|
|||
|
|
scene = new Scene();
|
|||
|
|
scene.begin();
|
|||
|
|
|
|||
|
|
// 创建测试实体
|
|||
|
|
entities = [];
|
|||
|
|
|
|||
|
|
// 实体1: 移动的活体
|
|||
|
|
const entity1 = scene.createEntity('MovingAlive');
|
|||
|
|
entity1.addComponent(new Position(10, 20));
|
|||
|
|
entity1.addComponent(new Velocity(1, 0));
|
|||
|
|
entity1.addComponent(new Health(100));
|
|||
|
|
entities.push(entity1);
|
|||
|
|
|
|||
|
|
// 实体2: 静止的活体
|
|||
|
|
const entity2 = scene.createEntity('StillAlive');
|
|||
|
|
entity2.addComponent(new Position(30, 40));
|
|||
|
|
entity2.addComponent(new Health(50));
|
|||
|
|
entities.push(entity2);
|
|||
|
|
|
|||
|
|
// 实体3: 移动的死体
|
|||
|
|
const entity3 = scene.createEntity('MovingDead');
|
|||
|
|
entity3.addComponent(new Position(50, 60));
|
|||
|
|
entity3.addComponent(new Velocity(0, 1));
|
|||
|
|
entity3.addComponent(new Dead());
|
|||
|
|
entities.push(entity3);
|
|||
|
|
|
|||
|
|
// 实体4: 静止的死体
|
|||
|
|
const entity4 = scene.createEntity('StillDead');
|
|||
|
|
entity4.addComponent(new Position(70, 80));
|
|||
|
|
entity4.addComponent(new Dead());
|
|||
|
|
entities.push(entity4);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
afterEach(() => {
|
|||
|
|
scene.end();
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('新API测试', () => {
|
|||
|
|
test('create()应该创建有效的matcher', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem);
|
|||
|
|
expect(matcher).toBeInstanceOf(Matcher);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('all()查询应该正确工作', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position, Health);
|
|||
|
|
|
|||
|
|
const result = matcher.query();
|
|||
|
|
expect(result).toHaveLength(2);
|
|||
|
|
expect(result.map(e => e.name).sort()).toEqual(['MovingAlive', 'StillAlive']);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('any()查询应该正确工作', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.any(Health, Dead);
|
|||
|
|
|
|||
|
|
const result = matcher.query();
|
|||
|
|
expect(result).toHaveLength(4); // 所有实体
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('none()查询应该正确工作', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position)
|
|||
|
|
.none(Dead);
|
|||
|
|
|
|||
|
|
const result = matcher.query();
|
|||
|
|
expect(result).toHaveLength(2);
|
|||
|
|
expect(result.map(e => e.name).sort()).toEqual(['MovingAlive', 'StillAlive']);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('复合查询应该正确工作', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position)
|
|||
|
|
.any(Health, Velocity)
|
|||
|
|
.none(Dead);
|
|||
|
|
|
|||
|
|
const result = matcher.query();
|
|||
|
|
expect(result).toHaveLength(2);
|
|||
|
|
expect(result.map(e => e.name).sort()).toEqual(['MovingAlive', 'StillAlive']);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('matches()应该正确检查单个实体', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position, Velocity);
|
|||
|
|
|
|||
|
|
expect(matcher.matches(entities[0])).toBe(true); // MovingAlive
|
|||
|
|
expect(matcher.matches(entities[1])).toBe(false); // StillAlive
|
|||
|
|
expect(matcher.matches(entities[2])).toBe(true); // MovingDead
|
|||
|
|
expect(matcher.matches(entities[3])).toBe(false); // StillDead
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('count()和exists()应该正确工作', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Health);
|
|||
|
|
|
|||
|
|
expect(matcher.count()).toBe(2);
|
|||
|
|
expect(matcher.exists()).toBe(true);
|
|||
|
|
|
|||
|
|
const emptyMatcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Health, Dead);
|
|||
|
|
|
|||
|
|
expect(emptyMatcher.count()).toBe(0);
|
|||
|
|
expect(emptyMatcher.exists()).toBe(false);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('clone()应该创建独立的matcher', () => {
|
|||
|
|
const baseMatcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position);
|
|||
|
|
|
|||
|
|
const livingMatcher = baseMatcher.clone()
|
|||
|
|
.all(Health)
|
|||
|
|
.none(Dead);
|
|||
|
|
|
|||
|
|
const deadMatcher = baseMatcher.clone()
|
|||
|
|
.all(Dead);
|
|||
|
|
|
|||
|
|
expect(livingMatcher.count()).toBe(2);
|
|||
|
|
expect(deadMatcher.count()).toBe(2);
|
|||
|
|
expect(baseMatcher.count()).toBe(4); // 原始matcher不受影响
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('reset()应该清空所有条件', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position)
|
|||
|
|
.any(Health)
|
|||
|
|
.none(Dead);
|
|||
|
|
|
|||
|
|
expect(matcher.count()).toBe(2);
|
|||
|
|
|
|||
|
|
matcher.reset();
|
|||
|
|
expect(matcher.count()).toBe(4); // 所有实体
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('向后兼容性测试', () => {
|
|||
|
|
test('empty()和withQuerySystem()应该正常工作', () => {
|
|||
|
|
const consoleSpy = jest.spyOn(console, 'warn').mockImplementation();
|
|||
|
|
|
|||
|
|
const matcher = Matcher.empty()
|
|||
|
|
.all(Position, Health)
|
|||
|
|
.withQuerySystem(scene.querySystem);
|
|||
|
|
|
|||
|
|
const result = matcher.query();
|
|||
|
|
expect(result).toHaveLength(2);
|
|||
|
|
|
|||
|
|
// 应该有deprecation警告
|
|||
|
|
expect(consoleSpy).toHaveBeenCalledWith(
|
|||
|
|
'withQuerySystem() is deprecated. Use Matcher.create(querySystem) instead.'
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
consoleSpy.mockRestore();
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('deprecated方法应该工作并显示警告', () => {
|
|||
|
|
const consoleSpy = jest.spyOn(console, 'warn').mockImplementation();
|
|||
|
|
|
|||
|
|
const matcher = Matcher.empty()
|
|||
|
|
.all(Position)
|
|||
|
|
.withQuerySystem(scene.querySystem);
|
|||
|
|
|
|||
|
|
// 测试deprecated方法
|
|||
|
|
expect(matcher.isInterestedEntity(entities[0])).toBe(true);
|
|||
|
|
const result = matcher.queryEntities();
|
|||
|
|
expect(result).toHaveLength(4);
|
|||
|
|
|
|||
|
|
// 测试getter方法
|
|||
|
|
expect(matcher.getAllSet()).toEqual([Position]);
|
|||
|
|
expect(matcher.getExclusionSet()).toEqual([]);
|
|||
|
|
expect(matcher.getOneSet()).toEqual([]);
|
|||
|
|
|
|||
|
|
// 验证警告
|
|||
|
|
expect(consoleSpy).toHaveBeenCalledWith(
|
|||
|
|
'isInterestedEntity() is deprecated. Use matches() instead.'
|
|||
|
|
);
|
|||
|
|
expect(consoleSpy).toHaveBeenCalledWith(
|
|||
|
|
'queryEntities() is deprecated. Use query() instead.'
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
consoleSpy.mockRestore();
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('无QuerySystem时应该抛出错误', () => {
|
|||
|
|
const consoleSpy = jest.spyOn(console, 'warn').mockImplementation();
|
|||
|
|
|
|||
|
|
const matcher = Matcher.empty()
|
|||
|
|
.all(Position, Health);
|
|||
|
|
|
|||
|
|
// 应该抛出错误而不是回退
|
|||
|
|
expect(() => matcher.matches(entities[0])).toThrow(
|
|||
|
|
'Matcher requires QuerySystem. Use Matcher.create(querySystem) or call withQuerySystem() first.'
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
expect(() => matcher.query()).toThrow(
|
|||
|
|
'Matcher requires QuerySystem. Use Matcher.create(querySystem) or call withQuerySystem() first.'
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
consoleSpy.mockRestore();
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('新旧API应该产生相同结果', () => {
|
|||
|
|
const consoleSpy = jest.spyOn(console, 'warn').mockImplementation();
|
|||
|
|
|
|||
|
|
// 旧API
|
|||
|
|
const oldMatcher = Matcher.empty()
|
|||
|
|
.all(Position)
|
|||
|
|
.exclude(Dead)
|
|||
|
|
.withQuerySystem(scene.querySystem);
|
|||
|
|
|
|||
|
|
// 新API
|
|||
|
|
const newMatcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position)
|
|||
|
|
.none(Dead);
|
|||
|
|
|
|||
|
|
// 结果应该相同
|
|||
|
|
const oldResult = oldMatcher.query().sort((a, b) => a.id - b.id);
|
|||
|
|
const newResult = newMatcher.query().sort((a, b) => a.id - b.id);
|
|||
|
|
|
|||
|
|
expect(oldResult).toEqual(newResult);
|
|||
|
|
|
|||
|
|
// 单个实体检查也应该相同
|
|||
|
|
for (const entity of entities) {
|
|||
|
|
expect(oldMatcher.matches(entity)).toBe(newMatcher.matches(entity));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
consoleSpy.mockRestore();
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('缓存机制测试', () => {
|
|||
|
|
test('条件变更应该使缓存失效', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position);
|
|||
|
|
|
|||
|
|
const result1 = matcher.query();
|
|||
|
|
|
|||
|
|
// 添加条件
|
|||
|
|
matcher.all(Health);
|
|||
|
|
const result2 = matcher.query();
|
|||
|
|
|
|||
|
|
// 结果应该不同
|
|||
|
|
expect(result2.length).toBeLessThan(result1.length);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('QuerySystem版本变更应该使缓存失效', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position);
|
|||
|
|
|
|||
|
|
const result1 = matcher.query();
|
|||
|
|
|
|||
|
|
// 添加新实体触发版本变更
|
|||
|
|
const newEntity = scene.createEntity('NewEntity');
|
|||
|
|
newEntity.addComponent(new Position(100, 100));
|
|||
|
|
|
|||
|
|
const result2 = matcher.query();
|
|||
|
|
|
|||
|
|
// 结果应该包含新实体
|
|||
|
|
expect(result2.length).toBe(result1.length + 1);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('重复查询应该使用缓存', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position);
|
|||
|
|
|
|||
|
|
const result1 = matcher.query();
|
|||
|
|
const result2 = matcher.query();
|
|||
|
|
|
|||
|
|
// 结果应该相同（功能测试，不测性能）
|
|||
|
|
expect(result1).toEqual(result2);
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('边界情况测试', () => {
|
|||
|
|
test('空条件应该返回所有实体', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem);
|
|||
|
|
const result = matcher.query();
|
|||
|
|
expect(result.length).toBeGreaterThan(0);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('不存在的组件查询应该返回空结果', () => {
|
|||
|
|
class NonExistentComponent extends Component {}
|
|||
|
|
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(NonExistentComponent);
|
|||
|
|
|
|||
|
|
expect(matcher.query()).toEqual([]);
|
|||
|
|
expect(matcher.count()).toBe(0);
|
|||
|
|
expect(matcher.exists()).toBe(false);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('复杂的排除条件应该正确工作', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position)
|
|||
|
|
.none(Health, Dead); // 排除有血量或死亡的
|
|||
|
|
|
|||
|
|
// 应该没有结果，因为所有有Position的实体都有Health或Dead
|
|||
|
|
expect(matcher.query()).toEqual([]);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('toString()应该提供有用的描述', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position, Health)
|
|||
|
|
.any(Velocity)
|
|||
|
|
.none(Dead);
|
|||
|
|
|
|||
|
|
const description = matcher.toString();
|
|||
|
|
expect(description).toContain('all(Position, Health)');
|
|||
|
|
expect(description).toContain('any(Velocity)');
|
|||
|
|
expect(description).toContain('none(Dead)');
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('getCondition()应该返回只读条件', () => {
|
|||
|
|
const matcher = Matcher.create(scene.querySystem)
|
|||
|
|
.all(Position)
|
|||
|
|
.any(Health)
|
|||
|
|
.none(Dead);
|
|||
|
|
|
|||
|
|
const condition = matcher.getCondition();
|
|||
|
|
expect(condition.all).toEqual([Position]);
|
|||
|
|
expect(condition.any).toEqual([Health]);
|
|||
|
|
expect(condition.none).toEqual([Dead]);
|
|||
|
|
|
|||
|
|
// 修改返回的条件不应该影响原matcher
|
|||
|
|
condition.all.push(Velocity as any);
|
|||
|
|
expect(matcher.getCondition().all).toEqual([Position]);
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
});
|