Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Perl Bindings to the Selenium Webdriver server
Perl Perl6 HTML JavaScript


Build Status

Selenium WebDriver is a test tool that allows you to write automated web application UI tests in any programming language against any HTTP website using any mainstream JavaScript-enabled browser. This module is a Perl implementation of the client for the Webdriver JSONWireProtocol that Selenium provides.

This module sends commands directly to the server using HTTP. Using this module together with the Selenium Server, you can automatically control any supported browser. To use this module, you need to have already downloaded and started the standalone Selenium Server.


It's probably easiest to use the cpanm or CPAN commands:

$ cpanm Selenium::Remote::Driver

If you want to install from this repository, you have a few options; see the installation docs for more details.


You can either use this module with the standalone java server, or use it to directly start the webdriver binaries for you. Note that the latter option does not require the JRE/JDK to be installed, nor does it require the selenium standalone server (despite the name of the main module!).

with a standalone server

Download the standalone server and have it running on port 4444; then the following should start up Firefox for you:


use strict;
use warnings;
use Selenium::Remote::Driver;

my $driver = Selenium::Remote::Driver->new;
print $driver->get_title . "\n"; # "Google"

my $query = $driver->find_element('q', 'name');
$query->send_keys('CPAN Selenium Remote Driver');

my $send_search = $driver->find_element('btnG', 'name');

# make the find_element blocking for a second to allow the title to change
my $results = $driver->find_element('search', 'id');

print $driver->get_title . "\n"; # CPAN Selenium Remote Driver - Google Search


use Selenium::Remote::Driver;

my $user = $ENV{SAUCE_USERNAME};

my $driver = Selenium::Remote::Driver->new(
    remote_server_addr => $user . ':' . $key . '',
    port => 80

print $driver->get_title();

There are additional usage examples on metacpan, and also in this project's wiki, including setting up the standalone server, running tests on Internet Explorer, Chrome, PhantomJS, and other useful example snippets.

no standalone server

  • Firefox: simply have the browser installed in the normal place for your OS.

  • Chrome: install the Chrome browser, download Chromedriver and get it in your $PATH:

  • PhantomJS: install the PhantomJS binary and get it in your $PATH

As long as the proper binary is available in your path, you should be able to do the following:

my $firefox = Selenium::Firefox->new;

my $chrome = Selenium::Chrome->new;

my $ghost = Selenium::PhantomJS->new;

Note that you can also pass a binary argument to any of the above classes to manually specify what binary to start:

my $chrome = Selenium::Chrome->new(binary => '~/Downloads/chromedriver');

See the pod for the different modules for more details.

Support and Documentation

There is a new mailing list available at!forum/selenium-remote-driver

for usage questions and ensuing discussions. If you've come across a bug, please open an issue in the Github issue tracker. The POD is available in the usual places, including metacpan, and in your shell via perldoc.

$ perldoc Selenium::Remote::Driver
$ perldoc Selenium::Remote::WebElement


Thanks for considering contributing! The contributing guidelines are also in the wiki. The documentation there also includes information on generating new recordings via

$ perl t/bin/

Copyright and License

Copyright (c) 2010-2011 Aditya Ivaturi, Gordon Child

Copyright (c) 2014 Daniel Gempesaw

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Something went wrong with that request. Please try again.