Luke Closs > Test-WWW-Selenium-1.22 > Test::WWW::Selenium

Download:
Test-WWW-Selenium-1.22.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  3
Open  3
View/Report Bugs
Module Version: 1.22   Source   Latest Release: Test-WWW-Selenium-1.36

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,
                                        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 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.

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.

syntax highlighting: