Test::Selenium::Remote::Driver
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.
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" )
TWD_
Set the Selenium server address with $TWD_HOST and $TWD_PORT.
$TWD_HOST
$TWD_PORT
Pick which browser is used using the $TWD_BROWSER, $TWD_VERSION, $TWD_PLATFORM, $TWD_JAVASCRIPT, $TWD_EXTRA_CAPABILITIES.
$TWD_BROWSER
$TWD_VERSION
$TWD_PLATFORM
$TWD_JAVASCRIPT
$TWD_EXTRA_CAPABILITIES
See Selenium::Driver::Remote for the meanings of these options.
Returns true if a Selenium server is running. The host and port parameters are optional, and default to localhost:4444.
localhost:4444
Environment vars TWD_HOST and TWD_PORT can also be used to determine the server to check.
TWD_HOST
TWD_PORT
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 ] );
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.
$search_target
$keys
Currently, other finders besides the default are not supported for type_ok().
type_ok()
$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().
default_finder
find_element_ok()
$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().
find_no_element_ok()
$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_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_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.
get_body()
To also match the HTML see, content_unlike().
content_unlike()
$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.
$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_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_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().
content_uncontains()
$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().
content_lacks()
$twd->element_text_is($search_target,$expected_text [,$desc]);
$twd->element_value_is($search_target,$expected_value [,$desc]);
$twd->click_element_ok($search_target [,$desc]);
Find an element and then click on it.
$twd->clear_element_ok($search_target [,$desc]);
Find an element and then clear on it.
$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]);
Find an element and check to confirm that it is enabled.
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.
Created by: Luke Closs <lukec@cpan.org>, but inspired by Test::WWW::Selenium and its authors.
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.
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.
To install Selenium::Remote::Driver, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Selenium::Remote::Driver
CPAN shell
perl -MCPAN -e shell install Selenium::Remote::Driver
For more information on module installation, please visit the detailed CPAN module installation guide.