games-testing

name	games-testing
description	Game testing production — Vitest config, headless Phaser/Three.js test helpers, E2E game test patterns, performance benchmark, memory leak detection.

games-testing — Game Testing Pipeline

Dùng khi cần test tự động cho game. Coverage target: > 80% game logic.

Setup

npm install -D vitest @testing-library/dom happy-dom
# Cho Phaser: npm install -D @phaserjs/phaser-testing
# Cho Three.js: npm install -D three (đã có)

Templates

File	Mô tả
vitest.config.ts	Vitest config với happy-dom + coverage
game-test-utils.ts	Helper: mock game loop, assert FSM state, simulate input
phaser-test-helper.ts	Headless Phaser scene test
three-test-helper.ts	Headless Three.js render test
performance-benchmark.ts	FPS + memory benchmark test
game-logic.test.ts	Mẫu test: FSM, collision, scoring, spawn
memory-leak.test.ts	Phát hiện memory leak trong game loop
game-eval-schema.ts	Eval assertions: assertGameInit, assertPhysicsStable, assertCheckpointTrigger, assertFPS, assertMemoryLeak, assertFSM, assertAudioPlay, assertInputResponsive

Eval assertions (kiểm tra chất lượng)

Dùng game-eval-schema.ts để verify game không bị "cùi":

import { assertPhysicsStable, assertCheckpointTrigger, assertFPS, generateReport } from "./game-eval-schema";

it("physics stable", () => {
  const result = assertPhysicsStable(ball.body, world);
  expect(result.pass).toBe(true);
});

it("FPS target", () => {
  const result = assertFPS(fps, 55);
  expect(result.pass).toBe(true);
});

Chạy grader để có summary:

# Sau khi chạy vitest → xuất JSON report
node _shared/scripts/game-gen/eval-grader.js --input eval-report.json --threshold 0.8

Chạy test

npx vitest run              # Một lần
npx vitest --coverage       # Có coverage
npx vitest                  # Watch mode

Integration với CI/CD

Test tự động chạy trong GitHub Actions (xem CI/CD templates).

Checklist test coverage

• FSM state transitions (mọi state → mọi state)
• Collision detection AABB edge cases
• Bullet/enemy pool acquire/release
• Scoring system (0, max, overflow)
• Player health (damage, heal, death, invincibility)
• Enemy spawn timing
• Audio play/stop/restart không throw
• Scene lifecycle (create → update → destroy)
• Touch input simulation
• FPS benchmark ≥ 55 desktop / ≥ 30 mobile

Anti-Rationalization

Excuse	Reality
"Game logic test không cần, chơi tay là đủ"	Bug vào production vì không test FSM/collision
"Headless test khó setup"	Template có sẵn, copy → chạy
"Coverage game thấp cũng được"	Logic không test = bug không phát hiện

Red Flags

• FSM transition không được test
• Performance benchmark không chạy
• Memory leak test missing

Verification

• FSM state transitions test
• Performance + memory benchmark pass
• eval-grader threshold ≥ 0.8