# ortonikc/lambdatest-playwright-java architecture

> Architecture diagram of the GitHub repository ortonikc/lambdatest-playwright-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ortonikc/lambdatest-playwright-java
- Repository: https://github.com/ortonikc/lambdatest-playwright-java

## Overview

##### Project type and purpose
- This is a Java-based end-to-end test automation framework built on Playwright and TestNG, packaged with Maven.
- It follows a Page Object Model (POM) for maintainability, and is designed to run tests locally or on a cloud service (LambdaTest), as demonstrated in the tutorial series.

##### File structure
- **pom.xml**: Maven build config, dependencies (Playwright, TestNG, LambdaTest).
- **src/main/java/base**: Core framework classes
- Driver.java – singleton/factory for browser instances
- PlaywrightConnection.java – handles local vs. cloud Playwright sessions
- LTCapability.java – builds cloud execution capabilities
- **src/main/java/com/lt/pages**: Page Object Model classes (LoginPage, RegisterAccountPage, HeaderSection)
- **src/test/java/**: Organized by tutorial topics—test classes that drive the framework via TestNG (browserContext, day2–day5, frames, alerts, pomTests, recordVideo, runningOnCloud, windowHandling).
- **testng.xml**: TestNG suite definition.
- **main/java/debugging**: Playwright Inspector demo.

##### README for insights
- The README links to a 13-part YouTube tutorial, covering installation, basic tests, inputs, dropdowns, screenshots, video recording, frames, windows/popups, multiple contexts, debugging, alerts, cloud execution, and Jenkins integration.

a. Main components
1. Test Runner Layer: TestNG (testng.xml, annotations)
2. Test Suites/Classes: src/test/java/*
3. Page Object Layer: com.lt.pages.*
4. Framework Core: base.Driver, PlaywrightConnection, LTCapability
5. Playwright & Browser: Playwright API → Browser → Browser Context → Page
6. External Services: LambdaTest Cloud (via LTCapability), Jenkins (CI pipeline)
7. Build & Dependency Manager: Maven (pom.xml)
b. Relationships and data flow
- TestNG loads testng.xml → executes Test Classes → each test calls Page Objects → Page Objects request a Playwright browser via Driver/PlaywrightConnection → actions dispatched to Browser Context → DOM interactions → results returned to tests.
- If cloud execution is enabled, PlaywrightConnection negotiates with LambdaTest API using LTCapability settings.
- Jenkins, when configured, invokes `mvn test` to run the suite in CI.
c. Architectural patterns & design principles
- Page Object Model (POM) to decouple test logic from UI locators and actions.
- Singleton or Factory pattern in Driver.java for browser instance management.
- Strategy pattern (local vs. cloud execution) in PlaywrightConnection and LTCapability.
- Layered architecture: Test → POM → Framework Core → External Services.
d. Key technologies & frameworks
- Java 17+ (assumed)
- Playwright Java client
- TestNG
- Maven
- LambdaTest cloud grid
- Jenkins (CI)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% CI/CD Layer
    Jenkins["Jenkins (CI)"]:::service
    Jenkins -->|"mvn test"| pom

    %% Build & Configurations
    pom["pom.xml"]:::config
    click pom "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/pom.xml"
    pom -->|"reads configurations"| testng
    testng["testng.xml"]:::config
    click testng "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/testng.xml"
    testng -->|"defines suite"| TestRunner

    %% Test Runner
    TestRunner["TestNG Runner"]:::code

    %% Test Suites Layer
    subgraph "Test Suites"
        subgraph "browserContext"
            BC["LearnBrowserContext"]:::code
            click BC "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/browserContext/LearnBrowserContext.java"
        end
        subgraph "day2"
            D2["LaunchBrowser"]:::code
            click D2 "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/day2/LaunchBrowser.java"
        end
        subgraph "day3"
            D3["InteractWithInputs"]:::code
            click D3 "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/day3/InteractWithInputs.java"
        end
        subgraph "day4"
            D4["InteractWithDropdowns"]:::code
            click D4 "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/day4/InteractWithDropdowns.java"
        end
        subgraph "day5"
            D5["LearnScreenshots"]:::code
            click D5 "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/day5/LearnScreenshots.java"
        end
        subgraph "frames"
            FR["LearnFrames"]:::code
            click FR "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/frames/LearnFrames.java"
        end
        subgraph "learnAlerts"
            AL["HandlingAlerts"]:::code
            click AL "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/learnAlerts/HandlingAlerts.java"
        end
        subgraph "pomTests"
            POMTS1["LoginUserTC"]:::code
            click POMTS1 "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/pomTests/LoginUserTC.java"
            POMTS2["RegisterUserTC"]:::code
            click POMTS2 "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/pomTests/RegisterUserTC.java"
        end
        subgraph "recordVideo"
            VID["LoginLogout"]:::code
            click VID "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/recordVideo/LoginLogout.java"
        end
        subgraph "runningOnCloud"
            CE1["BasicLoginDemo"]:::code
            click CE1 "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/runningOnCloud/BasicLoginDemo.java"
            CE2["TestNGDemoTest"]:::code
            click CE2 "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/runningOnCloud/TestNGDemoTest.java"
        end
        subgraph "windowHandling"
            WH["LearnWindowHandling"]:::code
            click WH "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/test/java/windowHandling/LearnWindowHandling.java"
        end
    end

    TestRunner -->|"runs suites"| BC
    TestRunner --> D2
    TestRunner --> D3
    TestRunner --> D4
    TestRunner --> D5
    TestRunner --> FR
    TestRunner --> AL
    TestRunner --> POMTS1
    TestRunner --> POMTS2
    TestRunner --> VID
    TestRunner --> CE1
    TestRunner --> CE2
    TestRunner --> WH

    %% Debugging Demo
    DBG["LearnPlaywrightInspector"]:::code
    click DBG "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/main/java/debugging/LearnPlaywrightInspector.java"
    TestRunner -->|"runs demo"| DBG

    %% Page Object Layer
    subgraph "Page Object Layer"
        LoginPage["LoginPage"]:::code
        click LoginPage "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/main/java/com/lt/pages/LoginPage.java"
        RegisterPage["RegisterAccountPage"]:::code
        click RegisterPage "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/main/java/com/lt/pages/RegisterAccountPage.java"
        HeaderSection["HeaderSection"]:::code
        click HeaderSection "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/main/java/com/lt/pages/HeaderSection.java"
    end
    BC -->|"calls"| LoginPage
    D2 -->|"uses"| LoginPage
    POMTS1 -->|"uses"| LoginPage
    POMTS2 -->|"uses"| RegisterPage
    POMTS1 -->|"uses"| HeaderSection

    %% Framework Core Layer
    subgraph "Framework Core"
        Driver["Driver Factory"]:::code
        click Driver "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/main/java/base/Driver.java"
        PlayConn["PlaywrightConnection"]:::code
        click PlayConn "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/main/java/base/PlaywrightConnection.java"
        LTCap["LTCapability Builder"]:::code
        click LTCap "https://github.com/ortonikc/lambdatest-playwright-java/blob/main/src/main/java/base/LTCapability.java"
    end

    LoginPage -->|"requests browser"| Driver
    RegisterPage --> Driver
    Driver -->|"creates session"| PlayConn
    PlayConn -->|"strategy pattern"| LTCap
    LTCap -->|"cloud caps"| LambdaTest

    %% Playwright API Layer
    subgraph "Playwright API"
        Browser["Browser"]:::service
        Context["BrowserContext"]:::service
        Page["Page"]:::service
    end
    PlayConn -->|"launches"| Browser
    Browser -->|"creates"| Context
    Context -->|"opens"| Page
    Page -->|"interacts with DOM"| LoginPage

    %% External Services
    LambdaTest["LambdaTest Cloud"]:::ext

    %% Styles
    classDef config fill:#f9f,stroke:#333,stroke-width:1px;
    classDef code fill:#bbf,stroke:#333,stroke-width:1px;
    classDef service fill:#ffb,stroke:#333,stroke-width:1px;
    classDef ext fill:#bfb,stroke:#333,stroke-width:1px;
```
