Test::WWW::Selenium(3)User Contributed Perl DocumentatioTest::WWW::Selenium(3)NAMETest::WWW::Selenium - Test applications using Selenium Remote Control
SYNOPSISTest::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,
error_callback => sub { ... },
);
# 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/);
$sel->error_callback(sub {...});
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 METHODSTest::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.
error_callback
Sets the method to use when a corresponding selenium test is called
and fails. For example if you call text_like(...) and it fails the
sub defined in the error_callback will be called. This allows you
to perform various tasks to obtain additional details that occured
when obtianing the error. If this is set to undef then the callback
will not be issued.
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.
perl v5.14.1 2010-05-11 Test::WWW::Selenium(3)