Quick Start

Selenium is a native D implementation of the W3C WebDriver protocol. It drives Chrome, Firefox, Edge, and Safari directly over HTTP. The selenium:webdriver package provides the client, and selenium:grid provides Grid models and in-process routing scaffolding.

For protocol concepts and upstream product documentation, see the official Selenium documentation.

Installation

Add the complete package or a specific subpackage with DUB:

dub add selenium
dub add selenium:webdriver
dub add selenium:grid

Install the browser and matching WebDriver executable separately, then put the executable on PATH:

The library resolves executables but does not download or update them. Driver.start() scans the known executables in the table order and uses the first one found.

First Program

import selenium;

import std.stdio : writeln;

Driver driver = Driver.start(new Chrome());
scope (exit) driver.stop();

driver.go("https://example.com");
writeln(driver.title);

Driver.start() can instead select the first known WebDriver executable found on PATH. driver.stop() ends the session. See WebDriver for browser capabilities, element interaction, remote sessions, and shared bridges.

Grid

The selenium:grid package provides Grid status models, an in-process router, and hub and node scaffolding. It does not yet include a live HTTP server, node registration heartbeat, or complete session distribution.

import selenium.grid;

Hub hub = Hub.start(4444, "my-secret");
scope (exit) hub.stop();

See Grid for the implemented architecture, routes, and models.

Next Steps

• WebDriver for installation, browser capabilities, and an end-to-end example.
• Bridge for local processes, remote connections, sessions, status, and low-level commands.
• Driver for navigation, scripts, windows, frames, roots, cookies, and logging.
• Elements for locators, element state, interaction, scoped search, and shadow roots.
• Actions for W3C input sources and action sequences.
• Grid for models, hub and node scaffolding, and in-process routing.
• Testing and Contributing for development.