test: add e2e tests for docs sidebar navigation

2026-08-03 07:46:42 +02:00 · 2026-04-27 21:57:08 +08:00
parent 77cef7b93e
commit 85c8f45fb3
1 changed files with 69 additions and 0 deletions
@@ -0,0 +1,69 @@
+import { expect, test } from "@playwright/test";
+
+test.describe("Docs Sidebar - Guide Section", () => {
+  test.beforeEach(async ({ page }) => {
+    await page.goto("/guide/getting-started");
+  });
+
+  test("sidebar renders all guide links", async ({ page }) => {
+    const sidebar = page.locator(".VPSidebar, aside");
+    const guideLinks = [
+      "Getting started",
+      "Architecture",
+      "Configuration",
+      "Database",
+      "Deployment",
+      "Docker tags",
+      "Developer guide",
+      "Translation guide",
+      "Contributing",
+    ];
+    for (const linkText of guideLinks) {
+      await expect(sidebar.getByText(linkText, { exact: true }).first()).toBeVisible();
+    }
+  });
+
+  test("sidebar renders API reference links", async ({ page }) => {
+    const sidebar = page.locator(".VPSidebar, aside");
+    await expect(sidebar.getByText("REST API", { exact: true })).toBeVisible();
+    await expect(sidebar.getByText("Image engine", { exact: true })).toBeVisible();
+    await expect(sidebar.getByText("AI engine", { exact: true })).toBeVisible();
+  });
+
+  test("clicking Architecture navigates correctly", async ({ page }) => {
+    await page.locator(".VPSidebar a, aside a").filter({ hasText: "Architecture" }).click();
+    await expect(page).toHaveURL(/\/guide\/architecture/);
+    await expect(page.getByRole("heading", { name: /Architecture/ }).first()).toBeVisible();
+  });
+
+  test("clicking Configuration navigates correctly", async ({ page }) => {
+    await page.locator(".VPSidebar a, aside a").filter({ hasText: "Configuration" }).click();
+    await expect(page).toHaveURL(/\/guide\/configuration/);
+  });
+
+  test("clicking Deployment navigates correctly", async ({ page }) => {
+    await page.locator(".VPSidebar a, aside a").filter({ hasText: "Deployment" }).first().click();
+    await expect(page).toHaveURL(/\/guide\/deployment/);
+  });
+});
+
+test.describe("Docs Sidebar - API Reference Section", () => {
+  test("clicking REST API navigates correctly", async ({ page }) => {
+    await page.goto("/guide/getting-started");
+    await page.locator(".VPSidebar a, aside a").filter({ hasText: "REST API" }).click();
+    await expect(page).toHaveURL(/\/api\/rest/);
+    await expect(page.getByText("REST API Reference")).toBeVisible();
+  });
+
+  test("clicking Image engine navigates correctly", async ({ page }) => {
+    await page.goto("/api/rest");
+    await page.locator(".VPSidebar a, aside a").filter({ hasText: "Image engine" }).click();
+    await expect(page).toHaveURL(/\/api\/image-engine/);
+  });
+
+  test("clicking AI engine navigates correctly", async ({ page }) => {
+    await page.goto("/api/rest");
+    await page.locator(".VPSidebar a, aside a").filter({ hasText: "AI engine" }).click();
+    await expect(page).toHaveURL(/\/api\/ai/);
+  });
+});