Playwright + Java
Eclipse Edition

<!-- Playwright library -->
<dependency>
  <groupId>com.microsoft.playwright</groupId>
  <artifactId>playwright</artifactId>
  <version>1.44.0</version>
</dependency>

<!-- JUnit 5 for running tests -->
<dependency>
  <groupId>org.junit.jupiter</groupId>
  <artifactId>junit-jupiter</artifactId>
  <version>5.10.0</version>
  <scope>test</scope>
</dependency>

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.1.2</version>
</plugin>

import com.microsoft.playwright.*;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

public class FirstTest {

  @Test
  void openGoogle() {
    // try-with-resources: browser closes automatically when done
    try (Playwright pw = Playwright.create()) {

      Browser browser = pw.chromium().launch();
      Page    page    = browser.newPage();

      page.navigate("https://google.com");

      assertTrue(page.title().contains("Google"));
      System.out.println("✓ Test passed! Title: " + page.title());
    }
  }
}

// 1. By ARIA role — most reliable for buttons, links, headings
page.getByRole(AriaRole.BUTTON,
    new Page.GetByRoleOptions().setName("Login"))

// 2. By placeholder — for text inputs
page.getByPlaceholder("Username")

// 3. By label — for labeled form fields
page.getByLabel("Email address")

// 4. By visible text — for any element showing text
page.getByText("Welcome back")

// 5. CSS selector — fallback only
page.locator("#login-button")
page.locator(".product-title")

// Common actions on any locator
locator.click();           // click
locator.fill("text");     // type into input
locator.check();           // tick a checkbox
locator.selectOption("value"); // select dropdown
locator.hover();           // mouse hover

import com.microsoft.playwright.*;
import com.microsoft.playwright.options.AriaRole;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

public class LoginTest {

  @Test
  void loginWithGoodCredentials() {
    try (Playwright pw = Playwright.create()) {
      Browser browser = pw.chromium().launch(
        new BrowserType.LaunchOptions().setHeadless(false) // see the browser!
      );
      Page page = browser.newPage();
      page.navigate("https://www.saucedemo.com");

      // Use getByPlaceholder — clear and readable
      page.getByPlaceholder("Username").fill("standard_user");
      page.getByPlaceholder("Password").fill("secret_sauce");

      // Use getByRole for the button
      page.getByRole(AriaRole.BUTTON,
        new Page.GetByRoleOptions().setName("Login")).click();

      assertTrue(page.url().contains("inventory"),
        "Should redirect to inventory after login");
    }
  }
}

import com.microsoft.playwright.*;
import com.microsoft.playwright.options.AriaRole;
import org.junit.jupiter.api.*;
import static com.microsoft.playwright.assertions.PlaywrightAssertions.*;

public class SaucedemoTest {

  // Class-level fields — shared by all tests
  Playwright playwright;
  Browser    browser;
  Page       page;

  @BeforeEach                     // runs before EACH @Test
  void setUp() {
    playwright = Playwright.create();
    browser    = playwright.chromium().launch(
      new BrowserType.LaunchOptions().setHeadless(false));
    page       = browser.newPage();
    page.navigate("https://www.saucedemo.com");
  }

  @AfterEach                      // runs after EACH @Test — always
  void tearDown() {
    browser.close();
    playwright.close();
  }

  @Test
  void loginSucceeds() {
    page.getByPlaceholder("Username").fill("standard_user");
    page.getByPlaceholder("Password").fill("secret_sauce");
    page.getByRole(AriaRole.BUTTON,
      new Page.GetByRoleOptions().setName("Login")).click();
    assertThat(page).hasURL("https://www.saucedemo.com/inventory.html");
  }

  @Test
  void loginFails_wrongPassword() {
    page.getByPlaceholder("Username").fill("standard_user");
    page.getByPlaceholder("Password").fill("wrong123");
    page.getByRole(AriaRole.BUTTON,
      new Page.GetByRoleOptions().setName("Login")).click();
    assertThat(page.getByText("Epic sadface")).isVisible();
  }

  @Test
  void pageTitle_isCorrect() {
    assertThat(page).hasTitle("Swag Labs");
  }
}

// ✓ AUTO-WAIT (happens automatically — no code needed)
// Playwright checks: visible + stable + enabled before each action
page.getByRole(AriaRole.BUTTON,
  new Page.GetByRoleOptions().setName("Submit")).click();

// ✗ NEVER DO THIS — Thread.sleep is fragile and slow
// Thread.sleep(3000); // bad: always wastes 3 seconds

// ✓ EXPLICIT WAIT — for URL changes after navigation
page.getByRole(AriaRole.BUTTON,
  new Page.GetByRoleOptions().setName("Login")).click();
page.waitForURL("**/inventory.html");  // wait for redirect

// ✓ EXPLICIT WAIT — for dynamic content to appear
page.waitForSelector(".inventory_item");  // wait for products

// ✓ EXPLICIT WAIT — for all network activity to finish
page.waitForLoadState(LoadState.NETWORKIDLE);

// ✓ CHANGE TIMEOUT for one slow-loading element
page.getByText("Results loaded").waitFor(
  new Locator.WaitForOptions().setTimeout(10000)); // 10s just this once

package pages;

import com.microsoft.playwright.*;
import com.microsoft.playwright.options.AriaRole;

public class LoginPage {

  private final Page page;

  // All locators in ONE place — easy to update when UI changes
  private final Locator username;
  private final Locator password;
  private final Locator loginBtn;

  public LoginPage(Page page) {
    this.page     = page;
    this.username = page.getByPlaceholder("Username");
    this.password = page.getByPlaceholder("Password");
    this.loginBtn = page.getByRole(AriaRole.BUTTON,
      new Page.GetByRoleOptions().setName("Login"));
  }

  public void navigate() {
    page.navigate("https://www.saucedemo.com");
  }

  // One clean method — hides all the locator details
  public void login(String user, String pass) {
    username.fill(user);
    password.fill(pass);
    loginBtn.click();
  }

  public String getErrorMessage() {
    return page.locator("[data-test='error']").textContent();
  }
}

package tests;

import com.microsoft.playwright.*;
import org.junit.jupiter.api.*;
import pages.LoginPage;
import static com.microsoft.playwright.assertions.PlaywrightAssertions.*;

public class LoginTest {

  Playwright playwright;
  Browser    browser;
  Page       page;

  @BeforeEach
  void setUp() {
    playwright = Playwright.create();
    browser    = playwright.chromium().launch(
      new BrowserType.LaunchOptions().setHeadless(false));
    page       = browser.newPage();
  }

  @AfterEach
  void tearDown() {
    browser.close();
    playwright.close();
  }

  @Test
  void validLogin_succeeds() {
    LoginPage loginPage = new LoginPage(page);
    loginPage.navigate();
    loginPage.login("standard_user", "secret_sauce");
    assertThat(page).hasURL("https://www.saucedemo.com/inventory.html");
  }

  // Notice: no locators in the test — only readable method calls
}

<dependency>
  <groupId>com.google.code.gson</groupId>
  <artifactId>gson</artifactId>
  <version>2.10.1</version>
</dependency>

@Test
void apiReturnsUsers() {
  try (Playwright pw = Playwright.create()) {
    APIRequestContext req = pw.request().newContext(
      new APIRequest.NewContextOptions()
        .setBaseURL("https://reqres.in")
    );

    APIResponse response = req.get("/api/users?page=1");
    assertEquals(200, response.status());

    // Print response in Eclipse Console
    System.out.println("Response: " + response.text());
  }
}

@Test
void showErrorWhen_APIFails() {
  // Route ALL requests matching this URL pattern to our fake response
  page.route("**/api/products", route -> {
    route.fulfill(new Route.FulfillOptions()
      .setStatus(500)                   // fake a server error
      .setContentType("application/json")
      .setBody("{\"error\": \"Server down\"}"));
  });

  page.navigate("https://your-app.com/products");
  assertThat(page.getByText("Something went wrong")).isVisible();
}

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;

public class MultiBrowserTest {

  @ParameterizedTest
  @ValueSource(strings = {"chromium", "firefox", "webkit"})
  void loginWorksOnAllBrowsers(String browserName) {
    try (Playwright pw = Playwright.create()) {

      // Pick browser engine from the parameter
      BrowserType bt = switch (browserName) {
        case "firefox" -> pw.firefox();
        case "webkit"  -> pw.webkit();  // Safari engine
        default        -> pw.chromium();
      };

      Browser        browser = bt.launch();
      // BrowserContext = fresh session, like incognito — use per test
      BrowserContext ctx     = browser.newContext();
      Page           page    = ctx.newPage();

      page.navigate("https://www.saucedemo.com");
      page.getByPlaceholder("Username").fill("standard_user");
      page.getByPlaceholder("Password").fill("secret_sauce");
      page.getByRole(AriaRole.BUTTON,
        new Page.GetByRoleOptions().setName("Login")).click();

      assertThat(page).hasURL("https://www.saucedemo.com/inventory.html");

      ctx.close();     // close context
      browser.close(); // close browser
    }
  }
}

import java.nio.file.Paths;
import org.junit.jupiter.api.*;

public class TracedTest {

  Playwright     playwright;
  Browser        browser;
  BrowserContext context;   // needed for tracing
  Page           page;

  @BeforeEach
  void setUp() {
    playwright = Playwright.create();
    browser    = playwright.chromium().launch();
    context    = browser.newContext();

    // Start recording everything
    context.tracing().start(new Tracing.StartOptions()
      .setScreenshots(true)   // capture screenshots
      .setSnapshots(true));   // capture DOM snapshots

    page = context.newPage();
  }

  @AfterEach
  void tearDown(TestInfo testInfo) {
    String name = testInfo.getDisplayName()
      .replaceAll("[^a-zA-Z0-9]", "_");

    // Always save trace — review if test fails
    context.tracing().stop(new Tracing.StopOptions()
      .setPath(Paths.get("traces/" + name + ".zip")));

    // Screenshot ONLY if test failed
    if (testInfo.getExecutionException().isPresent()) {
      page.screenshot(new Page.ScreenshotOptions()
        .setPath(Paths.get("screenshots/" + name + ".png"))
        .setFullPage(true));
    }

    context.close();
    browser.close();
    playwright.close();
  }

  @Test
  void exampleTracedTest() {
    page.navigate("https://www.saucedemo.com");
    assertThat(page).hasTitle("Swag Labs");
  }
}

name: Playwright Tests

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Java 17
        uses: actions/setup-java@v4
        with:
          java-version: '17'
          distribution: 'temurin'

      - name: Install Playwright browsers
        run: |
          mvn exec:java -e \
            -Dexec.mainClass=com.microsoft.playwright.CLI \
            -Dexec.args=install \
            --no-transfer-progress

      - name: Run all tests
        run: mvn test --no-transfer-progress

      - name: Upload screenshots on failure
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: failure-screenshots
          path: screenshots/
          retention-days: 7

      - name: Upload traces on failure
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: test-traces
          path: traces/
          retention-days: 7

// AUTH TESTS — 3
1. validLogin_redirectsToInventory()
2. invalidPassword_showsErrorMessage()
3. lockedUser_showsLockedMessage()

// INVENTORY TESTS — 3
4. inventoryPage_showsProducts()
5. sortByPriceLowToHigh_works()
6. addToCart_updatesCartBadgeCount()

// CART & CHECKOUT TESTS — 4
7. addItem_appearsInCart()
8. removeItem_removesFromCart()
9. checkout_completesSuccessfully()
10. checkout_failsWithoutAddress()

# Playwright Java Test Suite

![Tests](https://github.com/YOUR_NAME/YOUR_REPO/actions/workflows/tests.yml/badge.svg)

A complete Playwright + Java automation suite using:
- Eclipse IDE
- Maven
- JUnit 5
- Page Object Model
- GitHub Actions CI

## Running locally in Eclipse
Right-click project → Run As → JUnit Test