Skip to main content

Web Testing with Ellithium

Ellithium provides a comprehensive API for web browser automation, built on top of Selenium WebDriver. This page covers the core concepts and techniques for web testing.

Setting Up WebDriver​

The DriverFactory class is the entry point for creating WebDriver instances:

// Basic Chrome setup
WebDriver driver = DriverFactory.getNewLocalDriver(LocalDriverType.Chrome);

// Configured Chrome setup
WebDriver driver = DriverFactory.getNewLocalDriver(
    LocalDriverType.Chrome,
    HeadlessMode.True,  // Run in headless mode
    PrivateMode.True,   // Use incognito/private mode
    PageLoadStrategyMode.Normal,
    WebSecurityMode.SecureMode,
    SandboxMode.Sandbox
);

Learn more in the Driver Factory documentation.

Working with Web Elements​

Ellithium's DriverActions class provides a unified API for all web interactions:

// Initialize DriverActions
DriverActions actions = new DriverActions(driver);

// Navigate to a website
actions.navigation().navigateToUrl("https://example.com");

// Basic interactions
actions.elements().clickOnElement(By.id("submitButton"));
actions.elements().sendData(By.id("username"), "testuser");
actions.elements().waitForElementToBeVisible(By.id("loadingIndicator"));

// Verify element states
boolean isDisplayed = actions.elements().isElementDisplayed(By.id("statusMessage"));
String text = actions.elements().getElementText(By.id("result"));

For detailed information on all available interactions, see the Interactions documentation.

Cross-Browser Testing​

Ellithium supports multiple browsers out of the box:

// Chrome
WebDriver chromeDriver = DriverFactory.getNewLocalDriver(LocalDriverType.Chrome);

// Firefox
WebDriver firefoxDriver = DriverFactory.getNewLocalDriver(LocalDriverType.Firefox);

// Edge
WebDriver edgeDriver = DriverFactory.getNewLocalDriver(LocalDriverType.Edge);

// Safari
WebDriver safariDriver = DriverFactory.getNewLocalDriver(LocalDriverType.Safari);

Remote Web Testing​

For executing tests on a Selenium Grid or cloud providers:

// Remote Chrome through Selenium Grid
WebDriver remoteDriver = DriverFactory.getNewRemoteDriver(
    RemoteDriverType.Remote_Chrome,
    new URL("http://localhost:4444/wd/hub"),
    capabilities
);

Page Object Pattern​

Ellithium works seamlessly with the Page Object Model pattern:

public class LoginPage {
    private final DriverActions actions;
    private final By usernameField = By.id("username");
    private final By passwordField = By.id("password");
    private final By loginButton = By.id("loginButton");
    
    public LoginPage(WebDriver driver) {
        this.actions = new DriverActions(driver);
    }
    
    public void login(String username, String password) {
        actions.elements().sendData(usernameField, username);
        actions.elements().sendData(passwordField, password);
        actions.elements().clickOnElement(loginButton);
    }
    
    public boolean isErrorMessageDisplayed() {
        return actions.elements().isElementDisplayed(By.id("errorMessage"));
    }
}

Handling Advanced Scenarios​

Working with Alerts​

// Accept alert dialog
actions.alerts().accept();

// Get alert text
String alertText = actions.alerts().getText();

// Send input to prompt
actions.alerts().sendData("User input");

Working with Frames​

// Switch to frame by locator
actions.frames().switchToFrame(By.id("myIframe"));

// Switch back to main document
actions.frames().switchToDefaultContent();

Working with Multiple Windows​

// Switch to a new window by title
actions.windows().switchToNewWindow("Payment Page");

// Close current window and return to main window
actions.windows().closeCurrentWindow();

JavaScript Operations​

// Click using JavaScript
actions.JSActions().javascriptClick(By.id("hiddenButton"));

// Scroll to element
actions.JSActions().scrollToElement(By.id("elementAtBottom"));

Handling Synchronization​

Ellithium provides built-in waits for robust synchronization:

// Wait for element conditions
actions.elements().waitForElementToBeVisible(By.id("loadingIndicator"));
actions.elements().waitForElementToDisappear(By.id("loadingIndicator"));

// Wait for page state
actions.waits().waitForTitleContains("Dashboard");
actions.waits().waitForUrlContains("/dashboard");

// Wait with custom timeout (seconds)
actions.elements().waitForElementToBeVisible(By.id("element"), 30);

// Wait with custom timeout and polling interval (ms)
actions.elements().waitForElementToBeClickable(By.id("button"), 10, 500);

Recording Test Sessions​

Capture video recordings of test sessions for debugging:

// Create recorder
ScreenRecorderActions recorder = new ScreenRecorderActions<>(driver);

// Start recording
recorder.startRecording("LoginTest");

// Perform test steps...

// Stop recording
recorder.stopRecording();

Next Steps​