Files
languard-servers-manager/frontend/tests-e2e/dashboard/dashboard.spec.ts
Tran G. (Revernomad) Khoa a688bdfdf9 docs: finalise Arma 3 UX enhancement plan and update project docs
- .claude/plan/arma3-ux-enhancement.md: full plan review pass
  - Add Progress Tracker table for session handoff
  - Fix Phase 1 field names to match ServerConfig model (password_admin,
    battleye, disable_von)
  - Fix Phase 2 rotation endpoints to use ServerService(db) inline pattern
  - Fix Phase 4 router/service: add get_by_slot() to PlayerRepository,
    add get_rcon_client() to ThreadRegistry, fix BanRepository.create()
    signature (expires_at not duration_minutes), correct router pattern
  - Fix Phase 6: already implemented, mark as SKIP
  - Fix CSS class names: btn-secondary→btn-ghost, input-base→neu-input
  - Add 19 implementation decisions from Q&A session to Coding Conventions
- CLAUDE.md: update status table, type mapping table, add plan summary
  and new endpoint list, add key implementation gotchas section
- frontend/README.md: replace Vite boilerplate with project README
- frontend/tests-e2e: E2E test improvements from previous session
  (mock-based login error test, full dashboard mock coverage)
2026-04-17 15:45:34 +07:00

234 lines
8.1 KiB
TypeScript

import { test, expect } from "@playwright/test";
import { DashboardPage } from "../pages/DashboardPage";
const MOCK_TOKEN = "mock-jwt-token";
const MOCK_USER = { id: 1, username: "admin", role: "admin" };
const MOCK_SERVERS = [
{
id: 1,
name: "A3Master",
game_type: "arma3",
status: "running",
port: 2302,
max_players: 64,
current_players: 32,
restart_count: 2,
auto_restart: true,
created_at: "2026-01-01T00:00:00Z",
},
{
id: 2,
name: "Arma3 Test Server",
game_type: "arma3",
status: "stopped",
port: 2303,
max_players: 32,
current_players: 0,
restart_count: 0,
auto_restart: false,
created_at: "2026-01-02T00:00:00Z",
},
];
/**
* Set up auth + mock all API calls the dashboard needs.
* IMPORTANT: Playwright checks routes in reverse registration order (last registered = first checked).
* So we register the catch-all FIRST, then specific routes AFTER so they take priority.
*/
async function setupDashboardMocks(page: import("@playwright/test").Page, servers = MOCK_SERVERS) {
// Set mock auth state in localStorage for both:
// 1) The Zustand persist store (key: languard-auth) so ProtectedLayout sees isAuthenticated: true
// 2) The raw token (key: languard_token) so the Axios interceptor adds the Bearer header
await page.addInitScript(({ token, user }) => {
localStorage.setItem("languard_token", token);
localStorage.setItem(
"languard-auth",
JSON.stringify({ state: { token, user }, version: 0 }),
);
}, { token: MOCK_TOKEN, user: MOCK_USER });
// Catch-all for unhandled API calls — register FIRST so it has lowest priority
await page.route("**/api/**", (route) =>
route.fulfill({
status: 200,
contentType: "application/json",
body: JSON.stringify({ success: true, data: null, error: null }),
}),
);
// Specific routes — register AFTER catch-all so they take priority
await page.route("**/api/auth/me", (route) =>
route.fulfill({
status: 200,
contentType: "application/json",
body: JSON.stringify({ success: true, data: MOCK_USER, error: null }),
}),
);
await page.route("**/api/servers**", (route) =>
route.fulfill({
status: 200,
contentType: "application/json",
body: JSON.stringify({ success: true, data: servers, error: null }),
}),
);
}
test.describe("Dashboard", () => {
let dashboardPage: DashboardPage;
test.beforeEach(async ({ page }) => {
await setupDashboardMocks(page);
dashboardPage = new DashboardPage(page);
await dashboardPage.goto();
});
test("should display dashboard header", async () => {
await expect(dashboardPage.content).toBeVisible({ timeout: 10_000 });
await expect(dashboardPage.content.locator("h1")).toContainText("Dashboard");
});
test("should show server count", async () => {
await expect(dashboardPage.content).toBeVisible({ timeout: 10_000 });
await expect(dashboardPage.content.locator("text=2 servers configured")).toBeVisible();
});
test("should render server cards", async () => {
await expect(dashboardPage.serverCards.first()).toBeVisible({ timeout: 10_000 });
const count = await dashboardPage.getServerCount();
expect(count).toBe(2);
});
test("should display server names in cards", async () => {
await expect(dashboardPage.serverCards.first()).toBeVisible({ timeout: 10_000 });
const name = await dashboardPage.getServerCardName(0);
expect(name).toContain("A3Master");
});
test("should show Add Server button", async () => {
await expect(dashboardPage.content).toBeVisible({ timeout: 10_000 });
await expect(dashboardPage.addServerButton).toBeVisible();
await expect(dashboardPage.addServerButton).toContainText("Add Server");
});
test("should show sidebar with server list", async () => {
await expect(dashboardPage.sidebar).toBeVisible({ timeout: 10_000 });
await expect(dashboardPage.sidebar.locator("text=Servers")).toBeVisible();
await expect(dashboardPage.sidebar.locator("text=A3Master")).toBeVisible();
});
test("should show Stop button for running server", async () => {
await expect(dashboardPage.serverCards.first()).toBeVisible({ timeout: 10_000 });
const firstCard = dashboardPage.serverCards.nth(0);
await expect(firstCard.locator('button[aria-label^="Stop"]')).toBeVisible();
});
test("should show Start button for stopped server", async () => {
await expect(dashboardPage.serverCards.nth(1)).toBeVisible({ timeout: 10_000 });
const secondCard = dashboardPage.serverCards.nth(1);
await expect(secondCard.locator('button[aria-label^="Start"]')).toBeVisible();
});
test("should display player count in server card", async () => {
await expect(dashboardPage.serverCards.first()).toBeVisible({ timeout: 10_000 });
const firstCard = dashboardPage.serverCards.nth(0);
await expect(firstCard.locator("text=32/64")).toBeVisible();
});
test("should navigate to server detail on card click", async ({ page }) => {
await expect(dashboardPage.serverCards.first()).toBeVisible({ timeout: 10_000 });
// Click the server card link (not the sidebar link) — use .first() to avoid strict mode
const serverLink = page.locator('[data-testid="dashboard-content"] a[href="/servers/1"]');
await serverLink.click();
await expect(page).toHaveURL(/\/servers\/1/, { timeout: 5_000 });
});
});
test.describe("Dashboard - Empty State", () => {
test("should show empty state when no servers", async ({ page }) => {
await page.addInitScript(({ token, user }) => {
localStorage.setItem("languard_token", token);
localStorage.setItem(
"languard-auth",
JSON.stringify({ state: { token, user }, version: 0 }),
);
}, { token: MOCK_TOKEN, user: MOCK_USER });
// Catch-all first (lowest priority)
await page.route("**/api/**", (route) =>
route.fulfill({
status: 200,
contentType: "application/json",
body: JSON.stringify({ success: true, data: null, error: null }),
}),
);
// Specific routes after (higher priority)
await page.route("**/api/auth/me", (route) =>
route.fulfill({
status: 200,
contentType: "application/json",
body: JSON.stringify({ success: true, data: MOCK_USER, error: null }),
}),
);
await page.route("**/api/servers**", (route) =>
route.fulfill({
status: 200,
contentType: "application/json",
body: JSON.stringify({ success: true, data: [], error: null }),
}),
);
const dashboardPage = new DashboardPage(page);
await dashboardPage.goto();
await expect(dashboardPage.emptyState).toBeVisible({ timeout: 10_000 });
await expect(dashboardPage.emptyState.locator("text=No servers configured yet")).toBeVisible();
});
});
test.describe("Dashboard - Error State", () => {
test("should show error state when API fails", async ({ page }) => {
await page.addInitScript(({ token, user }) => {
localStorage.setItem("languard_token", token);
localStorage.setItem(
"languard-auth",
JSON.stringify({ state: { token, user }, version: 0 }),
);
}, { token: MOCK_TOKEN, user: MOCK_USER });
// Catch-all first (lowest priority)
await page.route("**/api/**", (route) =>
route.fulfill({
status: 200,
contentType: "application/json",
body: JSON.stringify({ success: true, data: null, error: null }),
}),
);
// Specific routes after (higher priority)
await page.route("**/api/auth/me", (route) =>
route.fulfill({
status: 200,
contentType: "application/json",
body: JSON.stringify({ success: true, data: MOCK_USER, error: null }),
}),
);
await page.route("**/api/servers**", (route) =>
route.fulfill({
status: 500,
contentType: "application/json",
body: JSON.stringify({ success: false, error: "Internal Server Error" }),
}),
);
const dashboardPage = new DashboardPage(page);
await dashboardPage.goto();
await expect(dashboardPage.errorMessage).toBeVisible({ timeout: 15_000 });
});
});