Selenium::Remote::Driver - Perl Client for Selenium Remote Driver
version 0.25
use Selenium::Remote::Driver; my $driver = Selenium::Remote::Driver->new; $driver->get('http://www.google.com'); print $driver->get_title(); $driver->quit();
Selenium is a test tool that allows you to write automated web application UI tests in any programming language against any HTTP website using any mainstream JavaScript-enabled browser. This module is an implementation of the client for the Remote driver that Selenium provides. You can find bindings for other languages at this location:
http://code.google.com/p/selenium/
This module sends commands directly to the Server using HTTP. Using this module together with the Selenium Server, you can automatically control any supported browser. To use this module, you need to have already downloaded and started the Selenium Server (Selenium Server is a Java application).
As of v0.25, it's possible to use this module without a standalone server - that is, you would not need the JRE or the JDK to run your Selenium tests. See Selenium::Chrome, Selenium::PhantomJS, and Selenium::Firefox for details. If you'd like additional browsers besides these, give us a holler over in Github.
Selenium::Remote::Driver uses the JsonWireProtocol to communicate with the Selenium Server. If an error occurs while executing the command then the server sends back an HTTP error code with a JSON encoded reponse that indicates the precise Response Error Code. The module will then croak with the error message associated with this code. If no error occurred, then the subroutine called will return the value sent back from the server (if a return value was sent).
So a rule of thumb while invoking methods on the driver is if the method did not croak when called, then you can safely assume the command was successful even if nothing was returned by the method.
Selenium Webdriver represents all the HTML elements as WebElement, which is in turn represented by Selenium::Remote::WebElement module. So any method that deals with WebElements will return and/or expect WebElement object. The POD for that module describes all the methods that perform various actions on the WebElements like click, submit etc.
To interact with any WebElement you have to first "find" it, read the POD for find_element or find_elements for further info. Once you find the required element then you can perform various actions. If you don't call find_* method first, all your further actions will fail for that element. Finally, just remember that you don't have to instantiate WebElement objects at all - they will be automatically created when you use the find_* methods.
A sub-class of Selenium::Remote::WebElement may be used instead of Selenium::Remote::WebElement, by providing that class name as an option the constructor:
my $driver = Selenium::Remote::Driver->new( webelement_class => ... );
For example, a testing-subclass may extend the web-element object with testing methods.
If are writing automated tests using this module, you may be interested in Test::Selenium::Remote::Driver which is also included in this distribution. It includes convenience testing methods for many of the selenum methods available here.
Your other option is to use this module in conjunction with your choice of testing modules, like Test::Spec or Test::More as you please.
Description: Constructor for Driver. It'll instantiate the object if it can communicate with the Selenium Webdriver server. Input: (all optional) Desired capabilities - HASH - Following options are accepted: Optional: 'remote_server_addr' - <string> - IP or FQDN of the Webdriver server machine 'port' - <string> - Port on which the Webdriver server is listening 'browser_name' - <string> - desired browser string: {phantomjs|firefox|internet explorer|htmlunit|iphone|chrome} 'version' - <string> - desired browser version number 'platform' - <string> - desired platform: {WINDOWS|XP|VISTA|MAC|LINUX|UNIX|ANY} 'javascript' - <boolean> - whether javascript should be supported 'accept_ssl_certs' - <boolean> - whether SSL certs should be accepted, default is true. 'firefox_profile' - Profile - Use Selenium::Firefox::Profile to create a Firefox profile for the browser to use 'proxy' - HASH - Proxy configuration with the following keys: 'proxyType' - <string> - REQUIRED, Possible values are: direct - A direct connection - no proxy in use, manual - Manual proxy settings configured, e.g. setting a proxy for HTTP, a proxy for FTP, etc, pac - Proxy autoconfiguration from a URL, autodetect - proxy autodetection, probably with WPAD, system - Use system settings 'proxyAutoconfigUrl' - <string> - REQUIRED if proxyType is 'pac', ignored otherwise. Expected format: http://hostname.com:1234/pacfile. 'ftpProxy' - <string> - OPTIONAL, ignored if proxyType is not 'manual'. Expected format: hostname.com:1234 'httpProxy' - <string> - OPTIONAL, ignored if proxyType is not 'manual'. Expected format: hostname.com:1234 'sslProxy' - <string> - OPTIONAL, ignored if proxyType is not 'manual'. Expected format: hostname.com:1234 'extra_capabilities' - HASH - Any other extra capabilities You can also specify some options in the constructor hash that are not part of the browser-related desired capabilities. These items are also optional. 'auto_close' - <boolean> - whether driver should end session on remote server on close. 'base_url' - <string> - OPTIONAL, base url for the website Selenium acts on. This can save you from repeating the domain in every call to $driver->get() 'default_finder' - <string> - choose default finder used for find_element* {class|class_name|css|id|link|link_text|name|partial_link_text|tag_name|xpath} 'inner_window_size' - <aref[Int]>- An array ref [ height, width ] that the browser window should use as its initial size immediately after instantiation 'webelement_class' - <string> - sub-class of Selenium::Remote::WebElement if you wish to use an alternate WebElement class. 'ua' - LWP::UserAgent instance - if you wish to use a specific $ua, like from Test::LWP::UserAgent If no values are provided, then these defaults will be assumed: 'remote_server_addr' => 'localhost' 'port' => '4444' 'browser_name' => 'firefox' 'version' => '' 'platform' => 'ANY' 'javascript' => 1 'auto_close' => 1 'default_finder' => 'xpath' Output: Remote Driver object Usage: my $driver = Selenium::Remote::Driver->new; or my $driver = Selenium::Remote::Driver->new('browser_name' => 'firefox', 'platform' => 'MAC'); or my $driver = Selenium::Remote::Driver->new('remote_server_addr' => '10.10.1.1', 'port' => '2222', 'auto_close' => 0); or my $driver = Selenium::Remote::Driver->new('browser_name' =>'chrome' 'extra_capabilities' => { 'chromeOptions' => { 'args' => [ 'window-size=1260,960', 'incognito' ], 'prefs' => { 'session' => { 'restore_on_startup' => 4, 'urls_to_restore_on_startup' => [ 'http://www.google.com', 'http://docs.seleniumhq.org' ]}, 'first_run_tabs' => [ 'http://www.google.com', 'http://docs.seleniumhq.org' ] } } }); or my $driver = Selenium::Remote::Driver->new('proxy' => {'proxyType' => 'manual', 'httpProxy' => 'myproxy.com:1234'}); or my $driver = Selenium::Remote::Driver->new('default_finder' => 'css');
Description: For experienced users who want complete control over the desired capabilities, use this alternative constructor along with the C<desired_capabilities> hash key in the init hash. Unlike "new", this constructor will not assume any defaults for your desired capabilities. This alternate constructor IGNORES all other browser-related desiredCapability options; the only options that will be respected are those that are NOT part of the Capabilities JSON Object as described in the Json Wire Protocol. Input: The only respected keys in the input hash are: desired_capabilities - HASHREF - defaults to {} remote_server_addr - STRING - defaults to localhost port - INTEGER - defaults to 4444 default_finder - STRING - defaults to xpath webelement_class - STRING - defaults to Selenium::Remote::WebElement auto_close - BOOLEAN - defaults to 1 Except for C<desired_capabilities>, these keys perform exactly the same as listed in the regular "new" constructor. The hashref you pass in as desired_capabilities only gets json encoded before being passed to the Selenium server; no default options of any sort will be added. This means you must handle normalization and casing of the input options (like "browser_name" vs "browserName") and take care of things like encoding the firefox profile if applicable. More information about the desired capabilities object is available on the Selenium wiki: https://code.google.com/p/selenium/wiki/JsonWireProtocol#Capabilities_JSON_Object Output: Remote Driver object Usage: my $driver = Selenium::Remote::Driver->new_from_caps( 'desired_capabilities' => {'browserName' => 'firefox'} ); The above would generate a POST to the webdriver server at localhost:4444 with the exact payload of '{"desiredCapabilities": {"browserName": "firefox" }}'.
Description: Turns on debugging mode and the driver will print extra info like request and response to stdout. Useful, when you want to see what is being sent to the server & what response you are getting back. Usage: $driver->debug_on;
Description: Turns off the debugging mode. Usage: $driver->debug_off;
Description: Returns a list of the currently active sessions. Each session will be returned as an array of Hashes with the following keys: 'id' : The session ID 'capabilities: An object describing session's capabilities Output: Array of Hashes Usage: print Dumper $driver->get_sessions();
Description: Query the server's current status. All server implementations should return two basic objects describing the server's current platform and when the server was built. Output: Hash ref Usage: print Dumper $driver->status;
Description: Gets the text of the currently displayed JavaScript alert(), confirm() or prompt() dialog. Example my $string = $driver->get_alert_text;
Description: Send a sequence of key strokes to the active element. This command is similar to the send keys command in every aspect except the implicit termination: The modifiers are not released at the end of the call. Rather, the state of the modifier keys is kept between calls, so mouse interactions can be performed while modifier keys are depressed. Input: 1 Required: {ARRAY | STRING} - Array of strings or a string. Usage: $driver->send_keys_to_active_element('abcd', 'efg'); $driver->send_keys_to_active_element('hijk'); or # include the WDKeys module use Selenium::Remote::WDKeys; . . $driver->send_keys_to_active_element(KEYS->{'space'}, KEYS->{'enter'});
Synonymous with send_keys_to_prompt
Description: Sends keystrokes to a JavaScript prompt() dialog. Input: {string} keys to send Example: $driver->send_keys_to_prompt('hello world'); or ok($driver->get_alert_text eq 'Please Input your name','prompt appears'); $driver->send_keys_to_alert("Larry Wall"); $driver->accept_alert;
Description: Accepts the currently displayed alert dialog. Usually, this is equivalent to clicking the 'OK' button in the dialog. Example: $driver->accept_alert;
Description: Dismisses the currently displayed alert dialog. For comfirm() and prompt() dialogs, this is equivalent to clicking the 'Cancel' button. For alert() dialogs, this is equivalent to clicking the 'OK' button. Example: $driver->dismiss_alert;
Description: Move the mouse by an offset of the specificed element. If no element is specified, the move is relative to the current mouse cursor. If an element is provided but no offset, the mouse will be moved to the center of the element. If the element is not visible, it will be scrolled into view. Output: STRING - Usage: # element - the element to move to. If not specified or is null, the offset is relative to current position of the mouse. # xoffset - X offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element. # yoffset - Y offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element. print $driver->mouse_move_to_location(element => e, xoffset => x, yoffset => y);
Synonymous with mouse_move_to_location
Description: Retrieve the capabilities of the specified session. Output: HASH of all the capabilities. Usage: my $capab = $driver->get_capabilities(); print Dumper($capab);
Description: Configure the amount of time that a particular type of operation can execute for before they are aborted and a |Timeout| error is returned to the client. Input: type - <STRING> - The type of operation to set the timeout for. Valid values are: "script" : for script timeouts, "implicit" : for modifying the implicit wait timeout "page load" : for setting a page load timeout. ms - <NUMBER> - The amount of time, in milliseconds, that time-limited commands are permitted to run. Usage: $driver->set_timeout('script', 1000);
Description: Set the amount of time, in milliseconds, that asynchronous scripts executed by execute_async_script() are permitted to run before they are aborted and a |Timeout| error is returned to the client. Input: ms - <NUMBER> - The amount of time, in milliseconds, that time-limited commands are permitted to run. Usage: $driver->set_async_script_timeout(1000);
Description: Set the amount of time the driver should wait when searching for elements. When searching for a single element, the driver will poll the page until an element is found or the timeout expires, whichever occurs first. When searching for multiple elements, the driver should poll the page until at least one element is found or the timeout expires, at which point it will return an empty list. If this method is never called, the driver will default to an implicit wait of 0ms. Input: Time in milliseconds. Output: Server Response Hash with no data returned back from the server. Usage: $driver->set_implicit_wait_timeout(10);
Description: Pause execution for a specified interval of milliseconds. Usage: $driver->pause(10000); # 10 second delay $driver->pause(); # 1 second delay default
Description: Close the current window. Usage: $driver->close(); or #close a popup window my $handles = $driver->get_window_handles; $driver->switch_to_window($handles->[1]); $driver->close(); $driver->switch_to_window($handles->[0]);
Description: Delete the session & close open browsers. Usage: $driver->quit();
Description: Retrieve the current window handle. Output: STRING - the window handle Usage: print $driver->get_current_window_handle();
Description: Retrieve the list of window handles used in the session. Output: ARRAY of STRING - list of the window handles Usage: print Dumper $driver->get_window_handles; or # get popup, close, then back my $handles = $driver->get_window_handles; $driver->switch_to_window($handles->[1]); $driver->close; $driver->switch_to_window($handles->[0]);
Description: Retrieve the window size Input: STRING - <optional> - window handle (default is 'current' window) Output: HASH - containing keys 'height' & 'width' Usage: my $window_size = $driver->get_window_size(); print $window_size->{'height'}, $window_size->('width');
Description: Retrieve the window position Input: STRING - <optional> - window handle (default is 'current' window) Output: HASH - containing keys 'x' & 'y' Usage: my $window_size = $driver->get_window_position(); print $window_size->{'x'}, $window_size->('y');
Description: Retrieve the url of the current page Output: STRING - url Usage: print $driver->get_current_url();
Description: Navigate to a given url. This is same as get() method. Input: STRING - url Usage: $driver->navigate('http://www.google.com');
Description: Navigate to a given url Input: STRING - url Usage: $driver->get('http://www.google.com');
Description: Get the current page title Output: STRING - Page title Usage: print $driver->get_title();
Description: Equivalent to hitting the back button on the browser. Usage: $driver->go_back();
Description: Equivalent to hitting the forward button on the browser. Usage: $driver->go_forward();
Description: Reload the current page. Usage: $driver->refresh();
Description: returns true if javascript is enabled in the driver. Usage: if ($driver->has_javascript) { ...; }
Description: Inject a snippet of JavaScript into the page for execution in the context of the currently selected frame. The executed script is assumed to be asynchronous and must signal that is done by invoking the provided callback, which is always provided as the final argument to the function. The value to this callback will be returned to the client. Asynchronous script commands may not span page loads. If an unload event is fired while waiting for a script result, an error should be returned to the client. Input: 2 (1 optional) Required: STRING - Javascript to execute on the page Optional: ARRAY - list of arguments that need to be passed to the script. Output: {*} - Varied, depending on the type of result expected back from the script. Usage: my $script = q{ var arg1 = arguments[0]; var callback = arguments[arguments.length-1]; var elem = window.document.findElementById(arg1); callback(elem); }; my $elem = $driver->execute_async_script($script,'myid'); $elem->click;
Description: Inject a snippet of JavaScript into the page and return its result. WebElements that should be passed to the script as an argument should be specified in the arguments array as WebElement object. Likewise, any WebElements in the script result will be returned as WebElement object. Input: 2 (1 optional) Required: STRING - Javascript to execute on the page Optional: ARRAY - list of arguments that need to be passed to the script. Output: {*} - Varied, depending on the type of result expected back from the script. Usage: my $script = q{ var arg1 = arguments[0]; var elem = window.document.findElementById(arg1); return elem; }; my $elem = $driver->execute_script($script,'myid'); $elem->click;
Description: Get a screenshot of the current page as a base64 encoded image. Output: STRING - base64 encoded image Usage: print $driver->screenshot();
To conveniently write the screenshot to a file, see capture_screenshot().
Description: Capture a screenshot and save as a PNG to provided file name. (The method is compatible with the WWW::Selenium method fo the same name) Output: TRUE - (Screenshot is written to file) Usage: $driver->capture_screenshot($filename);
Description: List all available engines on the machine. To use an engine, it has to be present in this list. Output: {Array.<string>} A list of available engines Usage: print Dumper $driver->available_engines;
Description: Change focus to another frame on the page. If the frame ID is null, the server will switch to the page's default content. You can also switch to a WebElement, for e.g. you can find an iframe using find_element & then provide that as an input to this method. Also see e.g. Input: 1 Required: {STRING | NUMBER | NULL | WebElement} - ID of the frame which can be one of the three mentioned. Usage: $driver->switch_to_frame('frame_1'); or $driver->switch_to_frame($driver->find_element('iframe', 'tag_name'));
Description: Change focus to another window. The window to change focus to may be specified by its server assigned window handle, or by the value of the page's window.name attribute. If you wish to use the window name as the target, you'll need to have set C<window.name> on the page either in app code or via L</execute_script>, or pass a name as the second argument to the C<window.open()> function when opening the new window. Note that the window name used here has nothing to do with the window title, or the C<< <title> >> element on the page. Otherwise, use L</get_window_handles> and select a Webdriver-generated handle from the output of that function. Input: 1 Required: STRING - Window handle or the Window name Usage: $driver->switch_to_window('MY Homepage'); or # close a popup window and switch back my $handles = $driver->get_window_handles; $driver->switch_to_window($handles->[1]); $driver->close; $driver->switch_to_window($handles->[0]);
Description: DEPRECATED - this function is a no-op in Webdriver, and will be removed in the upcoming version of this module. See https://groups.google.com/d/topic/selenium-users/oX0ZnYFPuSA/discussion and http://code.google.com/p/selenium/source/browse/trunk/java/client/src/org/openqa/selenium/WebDriverCommandProcessor.java
Description: Set the position (on screen) where you want your browser to be displayed. Input: INT - x co-ordinate INT - y co-ordinate STRING - <optional> - window handle (default is 'current' window) Output: BOOLEAN - Success or failure Usage: $driver->set_window_position(50, 50);
Description: Set the size of the browser window Input: INT - height of the window INT - width of the window STRING - <optional> - window handle (default is 'current' window) Output: BOOLEAN - Success or failure Usage: $driver->set_window_size(640, 480);
Description: Maximizes the browser window Input: STRING - <optional> - window handle (default is 'current' window) Output: BOOLEAN - Success or failure Usage: $driver->maximize_window();
Description: Retrieve all cookies visible to the current page. Each cookie will be returned as a HASH reference with the following keys & their value types: 'name' - STRING 'value' - STRING 'path' - STRING 'domain' - STRING 'secure' - BOOLEAN Output: ARRAY of HASHES - list of all the cookie hashes Usage: print Dumper($driver->get_all_cookies());
Description: Set a cookie on the domain. Input: 5 (1 optional) Required: 'name' - STRING 'value' - STRING 'path' - STRING 'domain' - STRING Optional: 'secure' - BOOLEAN - default is false. Usage: $driver->add_cookie('foo', 'bar', '/', '.google.com', 0)
Description: Delete all cookies visible to the current page. Usage: $driver->delete_all_cookies();
Description: Delete the cookie with the given name. This command will be a no-op if there is no such cookie visible to the current page. Input: 1 Required: STRING - name of cookie to delete Usage: $driver->delete_cookie_named('foo');
Description: Get the current page source. Output: STRING - The page source. Usage: print $driver->get_page_source();
Description: Search for an element on the page, starting from the document root. The located element will be returned as a WebElement object. If the element cannot be found, we will CROAK, killing your script. If you wish for a warning instead, use the parameterized version of the finders: find_element_by_class find_element_by_class_name find_element_by_css find_element_by_id find_element_by_link find_element_by_link_text find_element_by_name find_element_by_partial_link_text find_element_by_tag_name find_element_by_xpath These functions all take a single STRING argument: the locator search target of the element you want. If the element is found, we will receive a WebElement. Otherwise, we will return 0. Note that invoking methods on 0 will of course kill your script. Input: 2 (1 optional) Required: STRING - The search target. Optional: STRING - Locator scheme to use to search the element, available schemes: {class, class_name, css, id, link, link_text, partial_link_text, tag_name, name, xpath} Defaults to 'xpath' if not configured global during instantiation. Output: Selenium::Remote::WebElement - WebElement Object (This could be a subclass of L<Selenium::Remote::WebElement> if C<webelement_class> was set. Usage: $driver->find_element("//input[\@name='q']");
Description: Search for multiple elements on the page, starting from the document root. The located elements will be returned as an array of WebElement object. Input: 2 (1 optional) Required: STRING - The search target. Optional: STRING - Locator scheme to use to search the element, available schemes: {class, class_name, css, id, link, link_text, partial_link_text, tag_name, name, xpath} Defaults to 'xpath' if not configured global during instantiation. Output: ARRAY or ARRAYREF of WebElement Objects Usage: $driver->find_elements("//input");
Description: Search for an element on the page, starting from the identified element. The located element will be returned as a WebElement object. Input: 3 (1 optional) Required: Selenium::Remote::WebElement - WebElement object from where you want to start searching. STRING - The search target. (Do not use a double whack('//') in an xpath to search for a child element ex: '//option[@id="something"]' instead use a dot whack ('./') ex: './option[@id="something"]') Optional: STRING - Locator scheme to use to search the element, available schemes: {class, class_name, css, id, link, link_text, partial_link_text, tag_name, name, xpath} Defaults to 'xpath' if not configured global during instantiation. Output: WebElement Object Usage: my $elem1 = $driver->find_element("//select[\@name='ned']"); # note the usage of ./ when searching for a child element instead of // my $child = $driver->find_child_element($elem1, "./option[\@value='es_ar']");
Description: Search for multiple element on the page, starting from the identified element. The located elements will be returned as an array of WebElement objects. Input: 3 (1 optional) Required: Selenium::Remote::WebElement - WebElement object from where you want to start searching. STRING - The search target. Optional: STRING - Locator scheme to use to search the element, available schemes: {class, class_name, css, id, link, link_text, partial_link_text, tag_name, name, xpath} Defaults to 'xpath' if not configured global during instantiation. Output: ARRAY of WebElement Objects. Usage: my $elem1 = $driver->find_element("//select[\@name='ned']"); my $child = $driver->find_child_elements($elem1, "//option");
See "find_element".
Description: Get the element on the page that currently has focus.. The located element will be returned as a WebElement object. Output: WebElement Object Usage: $driver->get_active_element();
Description: Get the status of the html5 application cache. Usage: print $driver->cache_status; Output: <number> - Status code for application cache: {UNCACHED = 0, IDLE = 1, CHECKING = 2, DOWNLOADING = 3, UPDATE_READY = 4, OBSOLETE = 5}
Description: Set the current geographic location - note that your driver must implement this endpoint, or else it will crash your session. At the very least, it works in v2.12 of Chromedriver. Input: Required: HASH: A hash with key C<location> whose value is a Location hashref. See usage section for example. Usage: $driver->set_geolocation( location => { latitude => 40.714353, longitude => -74.005973, altitude => 0.056747 }); Output: BOOLEAN - success or failure
Description: Get the current geographic location. Note that your webdriver must implement this endpoint - otherwise, it will crash your session. At the time of release, we couldn't get this to work on the desktop FirefoxDriver or desktop Chromedriver. Usage: print $driver->get_geolocation; Output: { latitude: number, longitude: number, altitude: number } - The current geo location.
Description: Get the log for a given log type. Log buffer is reset after each request. Input: Required: <STRING> - Type of log to retrieve: {client|driver|browser|server}. There may be others available; see get_log_types for a full list for your driver. Usage: $driver->get_log( $log_type ); Output: <ARRAY|ARRAYREF> - An array of log entries since the most recent request.
Description: Get available log types. By default, every driver should have client, driver, browser, and server types, but there may be more available, depending on your driver. Usage: my @types = $driver->get_log_types; $driver->get_log($types[0]); Output: <ARRAYREF> - The list of log types.
Description: Set the browser orientation. Input: Required: <STRING> - Orientation {LANDSCAPE|PORTRAIT} Usage: $driver->set_orientation( $orientation ); Output: BOOLEAN - success or failure
Description: Get the current browser orientation. Returns either LANDSCAPE|PORTRAIT. Usage: print $driver->get_orientation; Output: <STRING> - your orientation.
Description: Send an event to the active element to depress or release a modifier key. Input: 2 Required: value - String - The modifier key event to be sent. This key must be one 'Ctrl','Shift','Alt',' or 'Command'/'Meta' as defined by the send keys command isdown - Boolean/String - Whether to generate a key down or key up Usage: $driver->send_modifier('Alt','down'); $elem->send_keys('c'); $driver->send_modifier('Alt','up'); or $driver->send_modifier('Alt',1); $elem->send_keys('c'); $driver->send_modifier('Alt',0);
Description: Test if two element IDs refer to the same DOM element. Input: 2 Required: Selenium::Remote::WebElement - WebElement Object Selenium::Remote::WebElement - WebElement Object Output: BOOLEAN Usage: $driver->compare_elements($elem_obj1, $elem_obj2);
Description: Click any mouse button (at the coordinates set by the last moveto command). Input: button - any one of 'LEFT'/0 'MIDDLE'/1 'RIGHT'/2 defaults to 'LEFT' Usage: $driver->click('LEFT'); $driver->click(1); #MIDDLE $driver->click('RIGHT'); $driver->click; #Defaults to left
Description: Double-clicks at the current mouse coordinates (set by moveto). Usage: $driver->double_click;
Description: Click and hold the left mouse button (at the coordinates set by the last moveto command). Note that the next mouse-related command that should follow is buttonup . Any other mouse command (such as click or another call to buttondown) will yield undefined behaviour. Usage: $self->button_down;
Description: Releases the mouse button previously held (where the mouse is currently at). Must be called once for every buttondown command issued. See the note in click and buttondown about implications of out-of-order commands. Usage: $self->button_up;
Description: Upload a file from the local machine to the selenium server machine. That file then can be used for testing file upload on web forms. Returns the remote-server's path to the file. Passing raw data as an argument past the filename will upload that rather than the file's contents. When passing raw data, be advised that it expects a zipped and then base64 encoded version of a single file. Multiple files are not supported by the remote server. Usage: my $remote_fname = $driver->upload_file( $fname ); my $element = $driver->find_element( '//input[@id="file"]' ); $element->send_keys( $remote_fname );
Description: Get the text of a particular element. Wrapper around L<find_element()> Usage: $text = $driver->get_text("//div[\@name='q']");
Description: Get the current text for the whole body. If you want the entire raw HTML instead, See L<get_page_source>. Usage: $body_text = $driver->get_body();
Description: Get the path part of the current browser location. Usage: $path = $driver->get_path();
Description: Convenience method to get the user agent string, according to the browser's value for window.navigator.userAgent. Usage: $user_agent = $driver->get_user_agent()
Description: Set the inner window size by closing the current window and reopening the current page in a new window. This can be useful when using browsers to mock as mobile devices. This sub will be fired automatically if you set the C<inner_window_size> hash key option during instantiation. Input: INT - height of the window INT - width of the window Output: BOOLEAN - Success or failure Usage: $driver->set_inner_window_size(640, 480)
Description: Get the value of a local storage item specified by the given key. Input: 1 Required: STRING - name of the key to be retrieved Output: STRING - value of the local storage item Usage: $driver->get_local_storage_item('key')
Description: Get the value of a local storage item specified by the given key. Input: 1 Required STRING - name of the key to be deleted Usage: $driver->delete_local_storage_item('key')
Please see those modules/websites for more information related to this module.
https://code.google.com/p/selenium/wiki/JsonWireProtocol#Capabilities_JSON_Object
https://github.com/gempesaw/Selenium-Remote-Driver/wiki
Brownie
Wight
Please report any bugs or feature requests on the bugtracker website https://github.com/gempesaw/Selenium-Remote-Driver/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
Aditya Ivaturi <ivaturi@gmail.com>
Daniel Gempesaw <gempesaw@gmail.com>
Luke Closs <cpan@5thplane.com>
Mark Stosberg <mark@stosberg.com>
Allen Lew <allen@alew.org>
George S. Baugh <george@troglodyne.net>
Gordon Child <gordon@gordonchild.com>
GreatFlamingFoo <greatflamingfoo@gmail.com>
Ivan Kurmanov <duraley@gmail.com>
Joe Higton <draxil@gmail.com>
Jon Hermansen <jon.hermansen@gmail.com>
Ken Swanson <kswanson@genome.wustl.edu>
Phil Kania <phil@vivox.com>
Phil Mitchell <phil.mitchell@pobox.com>
Robert Utter <utter.robert@gmail.com>
Bas Bloemsaat <bas@bloemsaat.com>
Tom Hukins <tom@eborcom.com>
Vishwanath Janmanchi <jvishwanath@gmail.com>
amacleay <a.macleay@gmail.com>
jamadam <sugama@jamadam.com>
Brian Horakh <brianh@zoovy.com>
Charles Howes <charles.howes@globalrelay.net>
Daniel Fackrell <dfackrell@bluehost.com>
Dave Rolsky <autarch@urth.org>
Dmitry Karasik <dmitry@karasik.eu.org>
Emmanuel Peroumalnaik <eperoumalnaik@weborama.com>
Eric Johnson <eric.git@iijo.org>
Gabor Szabo <gabor@szabgab.com>
Copyright (c) 2010-2011 Aditya Ivaturi, Gordon Child
Copyright (c) 2014 Daniel Gempesaw
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
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.