277 lines
9.0 KiB
TypeScript
277 lines
9.0 KiB
TypeScript
|
import { Component } from '../../src/ECS/Component';
|
|||
|
|
import { Entity } from '../../src/ECS/Entity';
|
|||
|
|
|
|||
|
|
// 测试组件
|
|||
|
|
class TestComponent extends Component {
|
|||
|
|
public value: number = 100;
|
|||
|
|
public onAddedCalled = false;
|
|||
|
|
public onRemovedCalled = false;
|
|||
|
|
public onEnabledCalled = false;
|
|||
|
|
public onDisabledCalled = false;
|
|||
|
|
public updateCalled = false;
|
|||
|
|
|
|||
|
|
public override onAddedToEntity(): void {
|
|||
|
|
this.onAddedCalled = true;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public override onRemovedFromEntity(): void {
|
|||
|
|
this.onRemovedCalled = true;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public override onEnabled(): void {
|
|||
|
|
this.onEnabledCalled = true;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public override onDisabled(): void {
|
|||
|
|
this.onDisabledCalled = true;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public override update(): void {
|
|||
|
|
this.updateCalled = true;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
class AnotherTestComponent extends Component {
|
|||
|
|
public name: string = 'test';
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
describe('Component - 组件基类测试', () => {
|
|||
|
|
let component: TestComponent;
|
|||
|
|
let entity: Entity;
|
|||
|
|
|
|||
|
|
beforeEach(() => {
|
|||
|
|
// Reset component ID generator to avoid BigInt issues
|
|||
|
|
Component._idGenerator = 0;
|
|||
|
|
component = new TestComponent();
|
|||
|
|
entity = new Entity('TestEntity', 1);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('基本功能', () => {
|
|||
|
|
test('应该能够创建组件实例', () => {
|
|||
|
|
expect(component).toBeInstanceOf(Component);
|
|||
|
|
expect(component).toBeInstanceOf(TestComponent);
|
|||
|
|
expect(component.id).toBeGreaterThanOrEqual(0);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('每个组件应该有唯一的ID', () => {
|
|||
|
|
const component1 = new TestComponent();
|
|||
|
|
const component2 = new TestComponent();
|
|||
|
|
const component3 = new AnotherTestComponent();
|
|||
|
|
|
|||
|
|
expect(component1.id).not.toBe(component2.id);
|
|||
|
|
expect(component2.id).not.toBe(component3.id);
|
|||
|
|
expect(component1.id).not.toBe(component3.id);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('组件ID应该递增分配', () => {
|
|||
|
|
const startId = Component._idGenerator;
|
|||
|
|
const component1 = new TestComponent();
|
|||
|
|
const component2 = new TestComponent();
|
|||
|
|
|
|||
|
|
expect(component2.id).toBe(component1.id + 1);
|
|||
|
|
expect(component1.id).toBeGreaterThanOrEqual(startId);
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('启用状态管理', () => {
|
|||
|
|
test('组件默认应该是启用的', () => {
|
|||
|
|
expect(component.enabled).toBe(true);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('设置组件禁用状态应该工作', () => {
|
|||
|
|
component.enabled = false;
|
|||
|
|
expect(component.enabled).toBe(false);
|
|||
|
|
expect(component.onDisabledCalled).toBe(true);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('重新启用组件应该工作', () => {
|
|||
|
|
component.enabled = false;
|
|||
|
|
component.onDisabledCalled = false;
|
|||
|
|
component.onEnabledCalled = false;
|
|||
|
|
|
|||
|
|
component.enabled = true;
|
|||
|
|
expect(component.enabled).toBe(true);
|
|||
|
|
expect(component.onEnabledCalled).toBe(true);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('设置相同的状态不应该触发回调', () => {
|
|||
|
|
component.enabled = true; // 已经是true
|
|||
|
|
expect(component.onEnabledCalled).toBe(false);
|
|||
|
|
|
|||
|
|
component.enabled = false;
|
|||
|
|
component.onDisabledCalled = false;
|
|||
|
|
|
|||
|
|
component.enabled = false; // 已经是false
|
|||
|
|
expect(component.onDisabledCalled).toBe(false);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('组件启用状态应该受实体状态影响', () => {
|
|||
|
|
entity.addComponent(component);
|
|||
|
|
expect(component.enabled).toBe(true);
|
|||
|
|
|
|||
|
|
// 禁用实体应该让组件表现为禁用
|
|||
|
|
entity.enabled = false;
|
|||
|
|
expect(component.enabled).toBe(false);
|
|||
|
|
|
|||
|
|
// 重新启用实体
|
|||
|
|
entity.enabled = true;
|
|||
|
|
expect(component.enabled).toBe(true);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('组件自身禁用时即使实体启用也应该是禁用的', () => {
|
|||
|
|
entity.addComponent(component);
|
|||
|
|
|
|||
|
|
component.enabled = false;
|
|||
|
|
entity.enabled = true;
|
|||
|
|
|
|||
|
|
expect(component.enabled).toBe(false);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('没有实体时组件状态应该只取决于自身', () => {
|
|||
|
|
// 组件还没有添加到实体
|
|||
|
|
expect(component.enabled).toBe(true);
|
|||
|
|
|
|||
|
|
component.enabled = false;
|
|||
|
|
expect(component.enabled).toBe(false);
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('更新顺序', () => {
|
|||
|
|
test('组件默认更新顺序应该是0', () => {
|
|||
|
|
expect(component.updateOrder).toBe(0);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('应该能够设置更新顺序', () => {
|
|||
|
|
component.updateOrder = 10;
|
|||
|
|
expect(component.updateOrder).toBe(10);
|
|||
|
|
|
|||
|
|
component.updateOrder = -5;
|
|||
|
|
expect(component.updateOrder).toBe(-5);
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('生命周期回调', () => {
|
|||
|
|
test('添加到实体时应该调用onAddedToEntity', () => {
|
|||
|
|
expect(component.onAddedCalled).toBe(false);
|
|||
|
|
|
|||
|
|
entity.addComponent(component);
|
|||
|
|
expect(component.onAddedCalled).toBe(true);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('从实体移除时应该调用onRemovedFromEntity', () => {
|
|||
|
|
entity.addComponent(component);
|
|||
|
|
expect(component.onRemovedCalled).toBe(false);
|
|||
|
|
|
|||
|
|
entity.removeComponent(component);
|
|||
|
|
expect(component.onRemovedCalled).toBe(true);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('启用时应该调用onEnabled', () => {
|
|||
|
|
component.enabled = false;
|
|||
|
|
component.onEnabledCalled = false;
|
|||
|
|
|
|||
|
|
component.enabled = true;
|
|||
|
|
expect(component.onEnabledCalled).toBe(true);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('禁用时应该调用onDisabled', () => {
|
|||
|
|
expect(component.onDisabledCalled).toBe(false);
|
|||
|
|
|
|||
|
|
component.enabled = false;
|
|||
|
|
expect(component.onDisabledCalled).toBe(true);
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('更新方法', () => {
|
|||
|
|
test('update方法应该可以被调用', () => {
|
|||
|
|
expect(component.updateCalled).toBe(false);
|
|||
|
|
|
|||
|
|
component.update();
|
|||
|
|
expect(component.updateCalled).toBe(true);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('基类的默认生命周期方法应该安全调用', () => {
|
|||
|
|
const baseComponent = new (class extends Component {})();
|
|||
|
|
|
|||
|
|
// 这些方法不应该抛出异常
|
|||
|
|
expect(() => {
|
|||
|
|
baseComponent.onAddedToEntity();
|
|||
|
|
baseComponent.onRemovedFromEntity();
|
|||
|
|
baseComponent.onEnabled();
|
|||
|
|
baseComponent.onDisabled();
|
|||
|
|
baseComponent.update();
|
|||
|
|
}).not.toThrow();
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('实体关联', () => {
|
|||
|
|
test('组件应该能够访问其所属的实体', () => {
|
|||
|
|
entity.addComponent(component);
|
|||
|
|
expect(component.entity).toBe(entity);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('组件移除后entity引用行为', () => {
|
|||
|
|
entity.addComponent(component);
|
|||
|
|
expect(component.entity).toBe(entity);
|
|||
|
|
|
|||
|
|
entity.removeComponent(component);
|
|||
|
|
// 移除后entity引用可能被清空，这是正常行为
|
|||
|
|
// 具体行为取决于实现，这里只测试不会抛出异常
|
|||
|
|
expect(() => {
|
|||
|
|
const _ = component.entity;
|
|||
|
|
}).not.toThrow();
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('边界情况', () => {
|
|||
|
|
test('多次启用禁用应该工作正常', () => {
|
|||
|
|
for (let i = 0; i < 10; i++) {
|
|||
|
|
component.enabled = false;
|
|||
|
|
expect(component.enabled).toBe(false);
|
|||
|
|
|
|||
|
|
component.enabled = true;
|
|||
|
|
expect(component.enabled).toBe(true);
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('极端更新顺序值应该被接受', () => {
|
|||
|
|
component.updateOrder = 999999;
|
|||
|
|
expect(component.updateOrder).toBe(999999);
|
|||
|
|
|
|||
|
|
component.updateOrder = -999999;
|
|||
|
|
expect(component.updateOrder).toBe(-999999);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('大量组件创建应该有不同的ID', () => {
|
|||
|
|
const components: Component[] = [];
|
|||
|
|
const count = 1000;
|
|||
|
|
|
|||
|
|
for (let i = 0; i < count; i++) {
|
|||
|
|
components.push(new TestComponent());
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 检查所有ID都不同
|
|||
|
|
const ids = new Set(components.map(c => c.id));
|
|||
|
|
expect(ids.size).toBe(count);
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
describe('继承和多态', () => {
|
|||
|
|
test('不同类型的组件应该都继承自Component', () => {
|
|||
|
|
const test1 = new TestComponent();
|
|||
|
|
const test2 = new AnotherTestComponent();
|
|||
|
|
|
|||
|
|
expect(test1).toBeInstanceOf(Component);
|
|||
|
|
expect(test2).toBeInstanceOf(Component);
|
|||
|
|
expect(test1).toBeInstanceOf(TestComponent);
|
|||
|
|
expect(test2).toBeInstanceOf(AnotherTestComponent);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
test('组件应该能够重写基类方法', () => {
|
|||
|
|
const test = new TestComponent();
|
|||
|
|
test.update();
|
|||
|
|
|
|||
|
|
expect(test.updateCalled).toBe(true);
|
|||
|
|
});
|
|||
|
|
});
|
|||
|
|
});
|