refactor: implement MdPage class for whitepaper tests

Author: pettinarip

tests/e2e/pages/MdPage.ts

@@ -0,0 +1,61 @@
+import { expect, Locator, Page } from "@playwright/test"
+
+import { BasePage } from "./BasePage"
+
+/**
+ * Generic Page Object Model for markdown pages
+ */
+export class MdPage extends BasePage {
+  protected url: string
+
+  constructor(page: Page, url: string) {
+    super(page)
+    this.url = url
+  }
+
+  /**
+   * Navigate to the markdown page
+   */
+  async goto() {
+    await this.navigateTo(this.url)
+  }
+
+  /**
+   * Verify the markdown page has loaded successfully
+   */
+  async verifyPageLoaded() {
+    await this.waitForPageReady()
+    await expect(this.page.locator("main")).toBeVisible()
+  }
+
+  /**
+   * Find a link by text pattern and return its locator
+   */
+  getLinkByText(textPattern: string | RegExp): Locator {
+    return this.page.getByRole("link", { name: textPattern })
+  }
+
+  /**
+   * Verify a link is visible
+   */
+  async verifyLinkVisible(textPattern: string | RegExp) {
+    const link = this.getLinkByText(textPattern)
+    await expect(link).toBeVisible()
+  }
+
+  /**
+   * Get the href attribute of a link
+   */
+  async getLinkHref(textPattern: string | RegExp): Promise<string | null> {
+    const link = this.getLinkByText(textPattern)
+    return await link.getAttribute("href")
+  }
+
+  /**
+   * Verify a link has the correct href
+   */
+  async verifyLinkHref(textPattern: string | RegExp, expectedPath: string) {
+    const href = await this.getLinkHref(textPattern)
+    expect(href).toContain(expectedPath)
+  }
+}

tests/e2e/whitepaper.spec.ts

@@ -1,19 +1,19 @@
 import { expect, request, test } from "@playwright/test"
 
+import { MdPage } from "./pages/MdPage"
+
 const PAGE_URL = "/whitepaper"
 const PDF_LINK_TEXT = /whitepaper.*pdf/i
 const PDF_PATH =
   "/content/whitepaper/whitepaper-pdf/Ethereum_Whitepaper_-_Buterin_2014.pdf"
 
 test.describe("Whitepaper Page", () => {
   test("whitepaper PDF link has correct href", async ({ page }) => {
-    await page.goto(PAGE_URL)
-
-    const pdfLink = page.getByRole("link", { name: PDF_LINK_TEXT })
-    await expect(pdfLink).toBeVisible()
-
-    const href = await pdfLink.getAttribute("href")
-    expect(href).toContain(PDF_PATH)
+    const whitepaperPage = new MdPage(page, PAGE_URL)
+    await whitepaperPage.goto()
+    await whitepaperPage.waitForPageReady()
+    await whitepaperPage.verifyLinkVisible(PDF_LINK_TEXT)
+    await whitepaperPage.verifyLinkHref(PDF_LINK_TEXT, PDF_PATH)
   })
 
   test("whitepaper PDF is accessible and served as PDF", async ({