- NAME
- SYNOPSIS
- REQUIREMENTS
- DESCRIPTION
- ADDITIONAL METHODS
- AUTHORS
- LICENSE

# 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");
        $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>

# 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