NAME

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

VERSION

       version 1.36

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", undef, "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 {...});

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.  The test name should always be the third
       argument.

NAME

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

REQUIREMENTS

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

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 occurred when obtianing the error. If
           this is set to undef then the callback will not be issued.

       $sel->debug()
           Starts an interactive shell to pass commands to Selenium.

           Commands are run against the selenium object, so you just need to type:

       eg: click("link=edit")

AUTHORS

       •   Maintained by: Matt Phillips <mattp@cpan.org>, Luke Closs <lukec@cpan.org>

       •   Originally by Mattia Barbon <mbarbon@cpan.org>

CONTRIBUTORS

       Dan Dascalescu

       Scott McWhirter

COPYRIGHT AND LICENSE

       Copyright (c) 2011 Matt Phillips <mattp@cpan.org>

       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.34.0                                       2022-06-28                           Test::WWW::Selenium(3pm)