NAME

Alien::SeleniumRC - Packages the Selenium Remote Control server.

SYNOPSIS

  use Alien::SeleniumRC;
  Alien::SeleniumRC::start();

DESCRIPTION

The Selenium Server (formerly known as Selenium RC Server) is at http://seleniumhq.org/download/

Selenium Server 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.

The Selenium Server is needed in order to run either Selenium RC style scripts or Remote Selenium Webdriver ones. The 2.x server is a drop-in replacement for the old Selenium RC server and is designed to be backwards compatible with your existing infrastructure.

Selenium Server can automatically start/stop/control any supported browser. It works by using Selenium Core, a pure-HTML+JS library that performs automated tasks in JavaScript.

METHODS

start

This method launches the Selenium Server bundled in this package. This call will block until the server is killed. The method will throw an exception with die if the system call returns an error.

The first argument passed to start() will be passed to selenium-server.jar as a command line argument.

help

Prints the selenium-server.jar usage.

UPDATING SELENIUM-SERVER.JAR

A copy of selenium-server.jar is installed in the Alien::SeleniumRC module directory. The Selenium RC version in this distribution is Version 3.141.59, released 2018-11-14.

To update your local copy, download SeleniumRC from http://seleniumhq.org/download/ and extract the file selenium-server.jar. Copy it to the Alien::SeleniumRC module directory. On most systems, you can find that path by typing

    perldoc -l Alien::SeleniumRC

ENVIRONMENT VARIABLES

Previous versions of Alien::SeleniumRC used sudo to launch the Java process using StartupItemContext when running under any version of Mac OSX. Running sudo in the middle of automated test suites can be problematic and not always required so from 1.01 on this is no longer the default behaviour.

To get the old behaviour back, set the environment variable SELENIUMRC_USE_SIC to a true value before calling start.

SEE ALSO

WWW::Selenium, Test::WWW::Selenium

Selenium Server home page: http://seleniumhq.org/projects/remote-control/

Selenium home page: http://seleniumhq.org/

LICENSE

This software is released under the same terms as perl itself. If you don't know what that means visit http://perl.com/

Copyright 2006 by Luke Closs

All rights Reserved

AUTHOR

Luke Closs <selenium-rc@awesnob.com>

Cygwin support provided by: Kevin Jones <kevin_jones@telus.net>

Co-maintainer Daniel Austin <hisso@cpan.org>