NAME
Test::Selenium::Remote::Driver
DESCRIPTION
A subclass of Selenium::Remote::Driver. which provides useful testing functions.
This is an experimental addition to the Selenium::Remote::Driver distribution, and some interfaces may change.
Methods
new ( %opts )
This will create a new Test::Selenium::Remote::Driver object, which subclasses Selenium::Remote::Driver. This subclass provides useful testing functions. It is modeled on Test::WWW::Selenium.
Environment vars can be used to specify options to pass to Selenium::Remote::Driver. ENV vars are prefixed with TWD_. ( After the old fork name, "Test::WebDriver" )
Set the Selenium server address with $TWD_HOST and $TWD_PORT.
Pick which browser is used using the $TWD_BROWSER, $TWD_VERSION, $TWD_PLATFORM, $TWD_JAVASCRIPT, $TWD_EXTRA_CAPABILITIES.
See Selenium::Driver::Remote for the meanings of these options.
server_is_running( $host, $port )
Returns true if a Selenium server is running. The host and port parameters are optional, and default to localhost:4444.
Environment vars TWD_HOST and TWD_PORT can also be used to determine the server to check.
Testing Methods
The following testing methods are available. For more documentation, see the related test methods in Selenium::Remote::Driver (And feel free to submit a patch to flesh out the documentation for these here).
alert_text_is
alert_text_isnt
alert_text_like
alert_text_unlike
current_window_handle_is
current_window_handle_isnt
current_window_handle_like
current_window_handle_unlike
window_handles_is
window_handles_isnt
window_handles_like
window_handles_unlike
window_size_is
window_size_isnt
window_size_like
window_size_unlike
window_position_is
window_position_isnt
window_position_like
window_position_unlike
current_url_is
current_url_isnt
current_url_like
current_url_unlike
title_is
title_isnt
title_like
title_unlike
active_element_is
active_element_isnt
active_element_like
active_element_unlike
# Basically the same as 'content_like()', but content_like() supports multiple regex's.
page_source_is
page_source_isnt
page_source_like
page_source_unlike
send_keys_to_active_element_ok
send_keys_to_alert_ok
send_keys_to_prompt_ok
send_modifier_ok
accept_alert_ok
dismiss_alert_ok
move_mouse_to_location_ok # TODO
move_to_ok # TODO
get_ok
go_back_ok
go_forward_ok
add_cookie_ok
get_page_source_ok
find_element_ok($search_target)
find_element_ok($search_target)
find_elements_ok
find_child_element_ok
find_child_elements_ok
compare_elements_ok
click_ok
double_click_ok$twd->type_element_ok($search_target, $keys, [, $desc ]);
$twd->type_element_ok( $search_target, $keys [, $desc ] );Use "find_element" in Selenium::Remote::Driver to resolve the $search_target to a web element, and then type $keys into it, providing an optional test label.
Currently, other finders besides the default are not supported for type_ok().
$twd->find_element_ok($search_target [, $desc ]);
$twd->find_element_ok( $search_target [, $desc ] );Returns true if $search_target is successfully found on the page. $search_target is passed to "find_element" in Selenium::Remote::Driver using the default_finder. See there for more details on the format. Currently, other finders besides the default are not supported for find_element_ok().
$twd->find_no_element_ok($search_target [, $desc ]);
$twd->find_no_element_ok( $search_target [, $desc ] );Returns true if $search_target is not found on the page. $search_target is passed to "find_element" in Selenium::Remote::Driver using the default_finder. See there for more details on the format. Currently, other finders besides the default are not supported for find_no_element_ok().
$twd->content_like( $regex [, $desc ] )
$twd->content_like( $regex [, $desc ] )
$twd->content_like( [$regex_1, $regex_2] [, $desc ] )Tells if the content of the page matches $regex. If an arrayref of regex's are provided, one 'test' is run for each regex against the content of the current page.
A default description of 'Content is like "$regex"' will be provided if there is no description.
$twd->content_unlike( $regex [, $desc ] )
$twd->content_unlike( $regex [, $desc ] )
$twd->content_unlike( [$regex_1, $regex_2] [, $desc ] )Tells if the content of the page does NOT match $regex. If an arrayref of regex's are provided, one 'test' is run for each regex against the content of the current page.
A default description of 'Content is unlike "$regex"' will be provided if there is no description.
$twd->body_text_like( $regex [, $desc ] )
$twd->body_text_like( $regex [, $desc ] )
$twd->body_text_like( [$regex_1, $regex_2] [, $desc ] )Tells if the text of the page (as returned by get_body()) matches $regex. If an arrayref of regex's are provided, one 'test' is run for each regex against the content of the current page.
A default description of 'Content is like "$regex"' will be provided if there is no description.
To also match the HTML see, content_unlike().
$twd->body_text_unlike( $regex [, $desc ] )
$twd->body_text_unlike( $regex [, $desc ] )
$twd->body_text_unlike( [$regex_1, $regex_2] [, $desc ] )Tells if the text of the page (as returned by get_body()) does NOT match $regex. If an arrayref of regex's are provided, one 'test' is run for each regex against the content of the current page.
A default description of 'Text is unlike "$regex"' will be provided if there is no description.
To also match the HTML see, content_unlike().
$twd->content_contains( $str [, $desc ] )
$twd->content_contains( $str [, $desc ] )
$twd->content_contains( [$str_1, $str_2] [, $desc ] )Tells if the content of the page contains $str. If an arrayref of strngs's are provided, one 'test' is run for each string against the content of the current page.
A default description of 'Content contains "$str"' will be provided if there is no description.
$twd->content_lacks( $str [, $desc ] )
$twd->content_lacks( $str [, $desc ] )
$twd->content_lacks( [$str_1, $str_2] [, $desc ] )Tells if the content of the page does NOT contain $str. If an arrayref of strings are provided, one 'test' is run for each string against the content of the current page.
A default description of 'Content lacks "$str"' will be provided if there is no description.
$twd->body_text_contains( $str [, $desc ] )
$twd->body_text_contains( $str [, $desc ] )
$twd->body_text_contains( [$str_1, $str_2] [, $desc ] )Tells if the text of the page (as returned by get_body()) contains $str. If an arrayref of strings are provided, one 'test' is run for each regex against the content of the current page.
A default description of 'Text contains "$str"' will be provided if there is no description.
To also match the HTML see, content_uncontains().
$twd->body_text_lacks( $str [, $desc ] )
$twd->body_text_lacks( $str [, $desc ] )
$twd->body_text_lacks( [$str_1, $str_2] [, $desc ] )Tells if the text of the page (as returned by get_body()) does NOT contain $str. If an arrayref of strings are provided, one 'test' is run for each regex against the content of the current page.
A default description of 'Text is lacks "$str"' will be provided if there is no description.
To also match the HTML see, content_lacks().
$twd->element_text_is($search_target,$expected_text [,$desc]);
$twd->element_text_is($search_target,$expected_text [,$desc]);$twd->element_value_is($search_target,$expected_value [,$desc]);
$twd->element_value_is($search_target,$expected_value [,$desc]);$twd->click_element_ok($search_target [,$desc]);
$twd->click_element_ok($search_target [,$desc]);Find an element and then click on it.
$twd->clear_element_ok($search_target [,$desc]);
$twd->clear_element_ok($search_target [,$desc]);Find an element and then clear on it.
$twd->is_element_displayed_ok($search_target [,$desc]);
$twd->is_element_displayed_ok($search_target [,$desc]);Find an element and check to confirm that it is displayed. (visible)
$twd->is_element_enabled_ok($search_target [,$desc]);
$twd->is_element_enabled_ok($search_target [,$desc]);Find an element and check to confirm that it is enabled.
NOTES
This module was forked from Test::WebDriver 0.01.
For Best Practice - I recommend subclassing Test::Selenium::Remote::Driver for your application, and then refactoring common or app specific methods into MyApp::WebDriver so that your test files do not have much duplication. As your app changes, you can update MyApp::WebDriver rather than all the individual test files.
AUTHORS
Created by: Luke Closs <lukec@cpan.org>, but inspired by Test::WWW::Selenium and its authors.
CONTRIBUTORS
Test::WebDriver work was sponsored by Prime Radiant, Inc. Mark Stosberg <mark@stosberg.com> forked it as Test::Selenium::Remote::Driver and significantly expanded it.
COPYRIGHT AND LICENSE
Parts Copyright (c) 2012 Prime Radiant, Inc.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.