testing

Testing Skill

Testing patterns for OpenCivilizations game.

Test Structure

client/
  __tests__/        # Client-side tests
    game/           # Game logic tests
    ui/             # UI component tests

server/
  __tests__/        # Server-side tests
    rooms/          # Room logic tests
    mechanics/      # Game mechanics tests

shared/
  __tests__/        # Shared utility tests

Running Tests

# All tests
npm test

# Client tests only
npm run test:client

# Server tests only
npm run test:server

# Watch mode
npm run test:watch

# Specific test file
npm test -- path/to/test.spec.ts

Test Patterns

Game Mechanics (Server)

import { calculateResources } from '../mechanics/resources';

describe('Resource Calculation', () => {
  it('calculates gold production based on time elapsed', () => {
    const player = { gold: 0, lastUpdate: Date.now() - 3600000 };
    const farms = [{ productionRate: 10 }];

    const result = calculateResources(player, farms);

    expect(result.gold).toBe(10); // 1 hour * 10/hour
  });
});

Colyseus Room (Server)

import { ColyseusTestServer } from '@colyseus/testing';
import { GameRoom } from '../rooms/GameRoom';

describe('GameRoom', () => {
  let colyseus: ColyseusTestServer;

  beforeAll(async () => {
    colyseus = new ColyseusTestServer();
    await colyseus.listen(2567);
  });

  afterAll(() => colyseus.shutdown());

  it('creates building when player has resources', async () => {
    const room = await colyseus.createRoom('game', {});
    const client = await colyseus.connectTo(room);

    client.send('build', { type: 'farm', x: 5, y: 5 });

    await room.waitForNextPatch();
    expect(room.state.buildings.length).toBe(1);
  });
});

Pathfinding (Client)

import { findPath } from '../systems/pathfinding';

describe('Pathfinding', () => {
  it('finds path around obstacles', () => {
    const grid = createGrid(10, 10);
    grid[5][5].walkable = false; // obstacle

    const path = findPath(grid, { x: 0, y: 0 }, { x: 9, y: 9 });

    expect(path).not.toContain({ x: 5, y: 5 });
    expect(path[path.length - 1]).toEqual({ x: 9, y: 9 });
  });
});