491 lines
15 KiB
TypeScript
491 lines
15 KiB
TypeScript
import { Core } from '../src/Core';
|
||
import { Scene } from '../src/ECS/Scene';
|
||
import { Entity } from '../src/ECS/Entity';
|
||
import { Component } from '../src/ECS/Component';
|
||
import { GlobalManager } from '../src/Utils/GlobalManager';
|
||
import { ITimer } from '../src/Utils/Timers/ITimer';
|
||
|
||
// 测试组件
|
||
class TestComponent extends Component {
|
||
public value: number;
|
||
|
||
constructor(...args: unknown[]) {
|
||
super();
|
||
const [value = 0] = args as [number?];
|
||
this.value = value;
|
||
}
|
||
}
|
||
|
||
// 测试场景
|
||
class TestScene extends Scene {
|
||
public initializeCalled = false;
|
||
public beginCalled = false;
|
||
public endCalled = false;
|
||
public updateCallCount = 0;
|
||
|
||
public override initialize(): void {
|
||
this.initializeCalled = true;
|
||
}
|
||
|
||
public override begin(): void {
|
||
this.beginCalled = true;
|
||
}
|
||
|
||
public override end(): void {
|
||
this.endCalled = true;
|
||
}
|
||
|
||
public override update(): void {
|
||
this.updateCallCount++;
|
||
}
|
||
}
|
||
|
||
// 测试全局管理器
|
||
class TestGlobalManager extends GlobalManager {
|
||
public updateCallCount = 0;
|
||
public override _enabled = false;
|
||
|
||
public override get enabled(): boolean {
|
||
return this._enabled;
|
||
}
|
||
|
||
public override set enabled(value: boolean) {
|
||
this._enabled = value;
|
||
}
|
||
|
||
public override update(): void {
|
||
this.updateCallCount++;
|
||
}
|
||
}
|
||
|
||
describe('Core - 核心管理系统测试', () => {
|
||
let originalConsoleWarn: typeof console.warn;
|
||
|
||
beforeEach(() => {
|
||
// 清除之前的实例
|
||
(Core as any)._instance = null;
|
||
|
||
// 模拟console.warn以避免测试输出
|
||
originalConsoleWarn = console.warn;
|
||
console.warn = jest.fn();
|
||
});
|
||
|
||
afterEach(() => {
|
||
// 恢复console.warn
|
||
console.warn = originalConsoleWarn;
|
||
|
||
// 清理Core实例
|
||
(Core as any)._instance = null;
|
||
});
|
||
|
||
describe('实例创建和管理', () => {
|
||
test('应该能够创建Core实例', () => {
|
||
const core = Core.create(true);
|
||
|
||
expect(core).toBeDefined();
|
||
expect(core).toBeInstanceOf(Core);
|
||
expect(core.debug).toBe(true);
|
||
expect(Core.entitySystemsEnabled).toBe(true);
|
||
});
|
||
|
||
test('应该能够通过配置对象创建Core实例', () => {
|
||
const config = {
|
||
debug: false,
|
||
enableEntitySystems: false
|
||
};
|
||
|
||
const core = Core.create(config);
|
||
|
||
expect(core.debug).toBe(false);
|
||
expect(Core.entitySystemsEnabled).toBe(false);
|
||
});
|
||
|
||
test('重复调用create应该返回同一个实例', () => {
|
||
const core1 = Core.create(true);
|
||
const core2 = Core.create(false); // 不同参数
|
||
|
||
expect(core1).toBe(core2);
|
||
});
|
||
|
||
test('应该能够获取Core实例', () => {
|
||
const core = Core.create(true);
|
||
const instance = Core.Instance;
|
||
|
||
expect(instance).toBe(core);
|
||
});
|
||
|
||
test('在未创建实例时调用update应该显示警告', () => {
|
||
Core.update(0.016);
|
||
|
||
expect(console.warn).toHaveBeenCalledWith("Core实例未创建，请先调用Core.create()");
|
||
});
|
||
});
|
||
|
||
describe('场景管理', () => {
|
||
let core: Core;
|
||
let testScene: TestScene;
|
||
|
||
beforeEach(() => {
|
||
core = Core.create(true);
|
||
testScene = new TestScene();
|
||
});
|
||
|
||
test('应该能够设置场景', () => {
|
||
Core.scene = testScene;
|
||
|
||
expect(Core.scene).toBe(testScene);
|
||
expect(testScene.beginCalled).toBe(true);
|
||
});
|
||
|
||
test('设置新场景应该触发场景切换', () => {
|
||
const firstScene = new TestScene();
|
||
const secondScene = new TestScene();
|
||
|
||
// 设置第一个场景
|
||
Core.scene = firstScene;
|
||
expect(firstScene.beginCalled).toBe(true);
|
||
|
||
// 设置第二个场景（应该在下一帧切换）
|
||
Core.scene = secondScene;
|
||
|
||
// 模拟更新循环触发场景切换
|
||
Core.update(0.016);
|
||
|
||
expect(firstScene.endCalled).toBe(true);
|
||
expect(secondScene.beginCalled).toBe(true);
|
||
expect(Core.scene).toBe(secondScene);
|
||
});
|
||
|
||
test('获取场景在未设置时应该返回null', () => {
|
||
expect(Core.scene).toBeNull();
|
||
});
|
||
});
|
||
|
||
describe('更新循环', () => {
|
||
let core: Core;
|
||
let testScene: TestScene;
|
||
let globalManager: TestGlobalManager;
|
||
|
||
beforeEach(() => {
|
||
core = Core.create(true);
|
||
testScene = new TestScene();
|
||
globalManager = new TestGlobalManager();
|
||
|
||
Core.registerGlobalManager(globalManager);
|
||
Core.scene = testScene;
|
||
});
|
||
|
||
test('应该能够执行更新循环', () => {
|
||
const deltaTime = 0.016;
|
||
|
||
Core.update(deltaTime);
|
||
|
||
expect(testScene.updateCallCount).toBe(1);
|
||
expect(globalManager.updateCallCount).toBe(1);
|
||
});
|
||
|
||
test('暂停状态下不应该执行更新', () => {
|
||
Core.paused = true;
|
||
|
||
Core.update(0.016);
|
||
|
||
expect(testScene.updateCallCount).toBe(0);
|
||
expect(globalManager.updateCallCount).toBe(0);
|
||
|
||
// 恢复状态
|
||
Core.paused = false;
|
||
});
|
||
|
||
test('禁用的全局管理器不应该被更新', () => {
|
||
globalManager.enabled = false;
|
||
|
||
Core.update(0.016);
|
||
|
||
expect(globalManager.updateCallCount).toBe(0);
|
||
});
|
||
|
||
test('多次更新应该累积调用', () => {
|
||
Core.update(0.016);
|
||
Core.update(0.016);
|
||
Core.update(0.016);
|
||
|
||
expect(testScene.updateCallCount).toBe(3);
|
||
expect(globalManager.updateCallCount).toBe(3);
|
||
});
|
||
});
|
||
|
||
describe('全局管理器管理', () => {
|
||
let core: Core;
|
||
let manager1: TestGlobalManager;
|
||
let manager2: TestGlobalManager;
|
||
|
||
beforeEach(() => {
|
||
core = Core.create(true);
|
||
manager1 = new TestGlobalManager();
|
||
manager2 = new TestGlobalManager();
|
||
});
|
||
|
||
test('应该能够注册全局管理器', () => {
|
||
Core.registerGlobalManager(manager1);
|
||
|
||
expect(manager1.enabled).toBe(true);
|
||
|
||
// 测试更新是否被调用
|
||
Core.update(0.016);
|
||
expect(manager1.updateCallCount).toBe(1);
|
||
});
|
||
|
||
test('应该能够注销全局管理器', () => {
|
||
Core.registerGlobalManager(manager1);
|
||
Core.unregisterGlobalManager(manager1);
|
||
|
||
expect(manager1.enabled).toBe(false);
|
||
|
||
// 测试更新不应该被调用
|
||
Core.update(0.016);
|
||
expect(manager1.updateCallCount).toBe(0);
|
||
});
|
||
|
||
test('应该能够获取指定类型的全局管理器', () => {
|
||
Core.registerGlobalManager(manager1);
|
||
|
||
const retrieved = Core.getGlobalManager(TestGlobalManager);
|
||
expect(retrieved).toBe(manager1);
|
||
});
|
||
|
||
test('获取不存在的管理器应该返回null', () => {
|
||
const retrieved = Core.getGlobalManager(TestGlobalManager);
|
||
expect(retrieved).toBeNull();
|
||
});
|
||
|
||
test('应该能够管理多个全局管理器', () => {
|
||
Core.registerGlobalManager(manager1);
|
||
Core.registerGlobalManager(manager2);
|
||
|
||
Core.update(0.016);
|
||
|
||
expect(manager1.updateCallCount).toBe(1);
|
||
expect(manager2.updateCallCount).toBe(1);
|
||
});
|
||
});
|
||
|
||
describe('定时器系统', () => {
|
||
let core: Core;
|
||
|
||
beforeEach(() => {
|
||
core = Core.create(true);
|
||
});
|
||
|
||
test('应该能够调度定时器', () => {
|
||
let callbackExecuted = false;
|
||
let timerInstance: ITimer | null = null;
|
||
|
||
const timer = Core.schedule(0.1, false, null, (timer) => {
|
||
callbackExecuted = true;
|
||
timerInstance = timer;
|
||
});
|
||
|
||
expect(timer).toBeDefined();
|
||
|
||
// 模拟时间推进
|
||
for (let i = 0; i < 10; i++) {
|
||
Core.update(0.016); // 约160ms总计
|
||
}
|
||
|
||
expect(callbackExecuted).toBe(true);
|
||
expect(timerInstance).toBe(timer);
|
||
});
|
||
|
||
test('应该能够调度重复定时器', () => {
|
||
let callbackCount = 0;
|
||
|
||
Core.schedule(0.05, true, null, () => {
|
||
callbackCount++;
|
||
});
|
||
|
||
// 模拟足够长的时间以触发多次回调
|
||
for (let i = 0; i < 15; i++) {
|
||
Core.update(0.016); // 约240ms总计，应该触发4-5次
|
||
}
|
||
|
||
expect(callbackCount).toBeGreaterThan(1);
|
||
});
|
||
|
||
test('应该支持带上下文的定时器', () => {
|
||
const context = { value: 42 };
|
||
let receivedContext: any = null;
|
||
|
||
Core.schedule(0.05, false, context, function(this: any, timer) {
|
||
receivedContext = this;
|
||
});
|
||
|
||
// 模拟时间推进
|
||
for (let i = 0; i < 5; i++) {
|
||
Core.update(0.016);
|
||
}
|
||
|
||
expect(receivedContext).toBe(context);
|
||
});
|
||
});
|
||
|
||
describe('调试功能', () => {
|
||
test('应该能够启用调试功能', () => {
|
||
const core = Core.create(true);
|
||
const debugConfig = {
|
||
enabled: true,
|
||
websocketUrl: 'ws://localhost:8080',
|
||
autoReconnect: true,
|
||
updateInterval: 1000,
|
||
channels: {
|
||
entities: true,
|
||
systems: true,
|
||
performance: true,
|
||
components: true,
|
||
scenes: true
|
||
}
|
||
};
|
||
|
||
Core.enableDebug(debugConfig);
|
||
|
||
expect(Core.isDebugEnabled).toBe(true);
|
||
});
|
||
|
||
test('应该能够禁用调试功能', () => {
|
||
const core = Core.create(true);
|
||
const debugConfig = {
|
||
enabled: true,
|
||
websocketUrl: 'ws://localhost:8080',
|
||
autoReconnect: true,
|
||
updateInterval: 1000,
|
||
channels: {
|
||
entities: true,
|
||
systems: true,
|
||
performance: true,
|
||
components: true,
|
||
scenes: true
|
||
}
|
||
};
|
||
|
||
Core.enableDebug(debugConfig);
|
||
Core.disableDebug();
|
||
|
||
expect(Core.isDebugEnabled).toBe(false);
|
||
});
|
||
|
||
test('在未创建实例时启用调试应该显示警告', () => {
|
||
const debugConfig = {
|
||
enabled: true,
|
||
websocketUrl: 'ws://localhost:8080',
|
||
autoReconnect: true,
|
||
updateInterval: 1000,
|
||
channels: {
|
||
entities: true,
|
||
systems: true,
|
||
performance: true,
|
||
components: true,
|
||
scenes: true
|
||
}
|
||
};
|
||
|
||
Core.enableDebug(debugConfig);
|
||
|
||
expect(console.warn).toHaveBeenCalledWith("Core实例未创建，请先调用Core.create()");
|
||
});
|
||
});
|
||
|
||
describe('ECS API集成', () => {
|
||
let core: Core;
|
||
let testScene: TestScene;
|
||
|
||
beforeEach(() => {
|
||
core = Core.create(true);
|
||
testScene = new TestScene();
|
||
});
|
||
|
||
test('设置支持ECS的场景应该初始化ECS API', () => {
|
||
// 模拟带有querySystem和eventSystem的场景
|
||
const ecsScene = Object.assign(testScene, {
|
||
querySystem: { query: jest.fn() },
|
||
eventSystem: { emit: jest.fn() }
|
||
});
|
||
|
||
Core.scene = ecsScene;
|
||
|
||
expect(Core.ecsAPI).toBeDefined();
|
||
});
|
||
|
||
test('设置普通场景不应该初始化ECS API', () => {
|
||
// 创建一个普通场景对象（不继承Scene）
|
||
const plainScene = {
|
||
initialize: () => {},
|
||
begin: () => {},
|
||
end: () => {},
|
||
update: () => {}
|
||
};
|
||
|
||
Core.scene = plainScene as any;
|
||
|
||
expect(Core.ecsAPI).toBeNull();
|
||
});
|
||
});
|
||
|
||
describe('性能监控集成', () => {
|
||
let core: Core;
|
||
|
||
beforeEach(() => {
|
||
core = Core.create(true);
|
||
});
|
||
|
||
test('调试模式下应该启用性能监控', () => {
|
||
const performanceMonitor = (core as any)._performanceMonitor;
|
||
|
||
expect(performanceMonitor).toBeDefined();
|
||
// 性能监控器应该在调试模式下被启用
|
||
expect(performanceMonitor.isEnabled).toBe(true);
|
||
});
|
||
|
||
test('更新循环应该包含性能监控', () => {
|
||
const scene = new TestScene();
|
||
Core.scene = scene;
|
||
|
||
const performanceMonitor = (core as any)._performanceMonitor;
|
||
const startMonitoringSpy = jest.spyOn(performanceMonitor, 'startMonitoring');
|
||
const endMonitoringSpy = jest.spyOn(performanceMonitor, 'endMonitoring');
|
||
|
||
Core.update(0.016);
|
||
|
||
expect(startMonitoringSpy).toHaveBeenCalled();
|
||
expect(endMonitoringSpy).toHaveBeenCalled();
|
||
});
|
||
});
|
||
|
||
describe('错误处理', () => {
|
||
test('设置null场景应该被忽略', () => {
|
||
Core.create(true);
|
||
|
||
expect(() => {
|
||
Core.scene = null;
|
||
}).not.toThrow();
|
||
|
||
expect(Core.scene).toBeNull();
|
||
});
|
||
|
||
test('应该处理场景更新中的异常', () => {
|
||
const core = Core.create(true);
|
||
const errorScene = new TestScene();
|
||
|
||
// 模拟场景更新抛出异常
|
||
errorScene.update = () => {
|
||
throw new Error('Test error');
|
||
};
|
||
|
||
Core.scene = errorScene;
|
||
|
||
// 由于Core目前不捕获场景异常，我们预期它会抛出异常
|
||
// 这是一个已知的行为，可以在未来版本中改进
|
||
expect(() => {
|
||
Core.update(0.016);
|
||
}).toThrow('Test error');
|
||
});
|
||
});
|
||
}); |