feat: add playwright-java skill for enterprise E2E test automation (#243)

skills/playwright-java/BasePage.java

@@ -0,0 +1,137 @@
+package com.company.tests.base;
+
+import com.company.tests.config.ConfigReader;
+import com.microsoft.playwright.Locator;
+import com.microsoft.playwright.Page;
+import com.microsoft.playwright.options.AriaRole;
+import com.microsoft.playwright.options.LoadState;
+import com.microsoft.playwright.options.WaitForSelectorState;
+import io.qameta.allure.Step;
+
+/**
+ * BasePage – foundation for all Page Object classes.
+ *
+ * Responsibilities:
+ * - Inject Page via constructor (never create Playwright here)
+ * - Provide common action helpers with Allure @Step reporting
+ * - Enforce strict locator strategy (role/label/testid first)
+ * - Declare getUrl() so pages can self-navigate
+ */
+public abstract class BasePage {
+
+    protected final Page page;
+
+    public BasePage(Page page) {
+        this.page = page;
+    }
+
+    // ─── Navigation ────────────────────────────────────────────────────────────
+
+    /** Navigate to this page's URL relative to baseUrl */
+    @Step("Navigate to {this.getUrl()}")
+    public <T extends BasePage> T navigate() {
+        page.navigate(ConfigReader.getBaseUrl() + getUrl());
+        waitForPageLoad();
+        //noinspection unchecked
+        return (T) this;
+    }
+
+    /** Each page declares its relative URL path, e.g. "/login" */
+    protected abstract String getUrl();
+
+    @Step("Wait for network idle")
+    protected void waitForPageLoad() {
+        page.waitForLoadState(LoadState.NETWORKIDLE);
+    }
+
+    // ─── Locator Shortcuts ──────────────────────────────────────────────────────
+
+    protected Locator byRole(AriaRole role, String name) {
+        return page.getByRole(role, new Page.GetByRoleOptions().setName(name));
+    }
+
+    protected Locator byLabel(String label) {
+        return page.getByLabel(label);
+    }
+
+    protected Locator byTestId(String testId) {
+        return page.getByTestId(testId);
+    }
+
+    protected Locator byText(String text) {
+        return page.getByText(text);
+    }
+
+    protected Locator byPlaceholder(String placeholder) {
+        return page.getByPlaceholder(placeholder);
+    }
+
+    // ─── Action Helpers ─────────────────────────────────────────────────────────
+
+    @Step("Fill '{locatorDesc}' with value")
+    protected void fill(Locator locator, String value) {
+        locator.waitFor(new Locator.WaitForOptions()
+            .setState(WaitForSelectorState.VISIBLE)
+            .setTimeout(10_000));
+        locator.clear();
+        locator.fill(value);
+    }
+
+    @Step("Click and wait for navigation")
+    protected void clickAndWaitForNav(Locator locator) {
+        page.waitForNavigation(() -> locator.click());
+    }
+
+    @Step("Click '{locatorDesc}'")
+    protected void click(Locator locator) {
+        locator.waitFor(new Locator.WaitForOptions()
+            .setState(WaitForSelectorState.VISIBLE)
+            .setTimeout(10_000));
+        locator.click();
+    }
+
+    @Step("Wait for element to be visible")
+    protected void waitForVisible(Locator locator, int timeoutMs) {
+        locator.waitFor(new Locator.WaitForOptions()
+            .setState(WaitForSelectorState.VISIBLE)
+            .setTimeout(timeoutMs));
+    }
+
+    @Step("Wait for element to be hidden")
+    protected void waitForHidden(Locator locator) {
+        locator.waitFor(new Locator.WaitForOptions()
+            .setState(WaitForSelectorState.HIDDEN)
+            .setTimeout(15_000));
+    }
+
+    @Step("Select option '{value}' from dropdown")
+    protected void selectOption(Locator locator, String value) {
+        locator.selectOption(value);
+    }
+
+    @Step("Check checkbox")
+    protected void check(Locator locator) {
+        if (!locator.isChecked()) locator.check();
+    }
+
+    @Step("Uncheck checkbox")
+    protected void uncheck(Locator locator) {
+        if (locator.isChecked()) locator.uncheck();
+    }
+
+    // ─── Scroll ─────────────────────────────────────────────────────────────────
+
+    protected void scrollIntoView(Locator locator) {
+        locator.scrollIntoViewIfNeeded();
+    }
+
+    // ─── Utility ────────────────────────────────────────────────────────────────
+
+    public String getCurrentUrl() {
+        return page.url();
+    }
+
+    public String getPageTitle() {
+        return page.title();
+    }
+}