Pcloudy is a cloud testing platform that gives you access to real browsers and devices directly from your automation scripts. This project is a simple Java Selenium example showing how to run browser automation on Pcloudy's remote Selenium grid.

• Java 11 or later
• Maven 3.8+ recommended
• A valid Pcloudy account
• Access to the Pcloudy Selenium endpoint

This repository contains a simple Selenium Java sample that runs a browser session on the Pcloudy cloud Selenium grid.

The sample:

• Connects to the Pcloudy remote Selenium hub
• Launches a Chrome browser session
• Opens Wikipedia
• Searches for Selenium
• Saves a screenshot under target/screenshots

• Remote WebDriver execution on Pcloudy
• Selenium 4 with Java 11
• TestNG annotations for test lifecycle management
• Automatic screenshot capture
• Maven-based project setup

• Language: Java
• Build tool: Maven
• Selenium version: 4.25.0
• Test framework: TestNG
• Java version: 11

pc-selenium-java/
|-- pom.xml
|-- README.md
`-- src
    `-- main
        `-- java
            `-- com
                `-- pcloudy
                    `-- selenium
                        `-- PcloudySeleniumRunner.java

Clone the repository and install dependencies:

git clone https://github.com/Pcloudy-Sample/PC-selenium-java
cd PC-selenium-java
mvn clean install

Open src/main/java/com/pcloudy/selenium/PcloudySeleniumRunner.java and update the following values:

• HUB_URL for the Pcloudy Selenium hub
• USER_NAME with your Pcloudy email
• ACCESS_KEY with your Pcloudy access key
• The buildOptions() values for your desired OS, browser version, project name, and build name

Example capability block:

static Map<String, Object> buildOptions() {
    Map<String, Object> options = new LinkedHashMap<>();
    options.put("userName", USER_NAME);
    options.put("accessKey", ACCESS_KEY);
    options.put("os", "Mac");
    options.put("osVersion", "Ventura");
    options.put("browserVersion", "134");
    options.put("seleniumVersion", "4.18.1");
    options.put("project", "Project_1");
    options.put("build", "staging_browser_run");
    options.put("name", "Wikipedia search");
    options.put("tag", "launch");
    options.put("local", false);
    options.put("pCloudy_EnableVideo", true);
    options.put("idleTimeout", 5);
    return options;
}

Run the sample through Maven exec:

mvn exec:java -Dexec.mainClass=com.pcloudy.selenium.PcloudySeleniumRunner

The PcloudySeleniumRunner class:

• Creates a RemoteWebDriver session using pcloudy:options
• Navigates to https://www.wikipedia.org/
• Waits for the search box to become clickable
• Searches for Selenium
• Captures a screenshot in target/screenshots
• Closes the browser session

• The project currently hardcodes the Pcloudy username and access key in the runner. For real usage, move these values to environment variables or a secure secret store.
• browserName is set to chrome in the runner.
• Screenshots are written to target/screenshots/ and are not committed to source control.
• The sample uses TestNG annotations, but the main method also allows it to run as a simple Java entry point.

• If the session does not start, verify the hub URL, username, and access key.
• If the browser fails to launch, confirm the selected os, osVersion, and browserVersion are supported by your Pcloudy plan.
• If Maven cannot resolve dependencies, make sure you have internet access and a working Maven installation.
• If screenshots are not created, check that the test reached the captureScreenshot step and that the process has write access to target/screenshots.

The project uses these Maven dependencies:

• org.seleniumhq.selenium:selenium-java
• org.testng:testng

• Pcloudy Website
• Selenium Documentation

Contributions are welcome. Please open an issue to discuss your idea before submitting a pull request.