NAME

Test::WWW::Selenium - Test applications using Selenium Remote Control

SYNOPSIS

Test::WWW::Selenium is a subclass of WWW::Selenium that provides convenient testing functions.

use Test::More tests => 5;
use Test::WWW::Selenium;

# Parameters are passed through to WWW::Selenium
my $sel = Test::WWW::Selenium->new( host => "localhost",
                                    port => 4444,
                                    browser => "*firefox",
                                    browser_url => "http://www.google.com",
                                    default_names => 1,
                                  );

# use special test wrappers around WWW::Selenium commands:
$sel->open_ok("http://www.google.com", "fetched G's site alright");
$sel->type_ok( "q", "hello world");
$sel->click_ok("btnG");
$sel->wait_for_page_to_load_ok(5000);
$sel->title_like(qr/Google Search/);

REQUIREMENTS

To use this module, you need to have already downloaded and started the Selenium Server. (The Selenium Server is a Java application.)

DESCRIPTION

This module is a WWW::Selenium subclass providing some methods useful for writing tests. For each Selenium command (open, click, type, ...) there is a corresponding <command>_ok method that checks the return value (open_ok, click_ok, type_ok).

For each Selenium getter (get_title, ...) there are four autogenerated methods (<getter>_is, <getter>_isnt, <getter>_like, <getter>_unlike) to check the value of the attribute.

By calling the constructor with default_names set to a true value your tests will be given a reasonable name should you choose not to provide one of your own.

ADDITIONAL METHODS

Test::WWW::Selenium also provides some other handy testing functions that wrap WWW::Selenium commands:

get_location

Returns the relative location of the current page. Works with _is, _like, ... methods.

AUTHORS

Maintained by Luke Closs <lukec@cpan.org>

Originally by Mattia Barbon <mbarbon@cpan.org>

Other contributors: Dan Dascalescu, Scott McWhirter.

LICENSE

Copyright (c) 2006 Luke Closs <lukec@cpan.org> Copyright (c) 2005, 2006 Mattia Barbon <mbarbon@cpan.org>

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.