Selenium::ActionChains - Action chains for Selenium::Remote::Driver
version 1.38
use Selenium::Remote::Driver; use Selenium::ActionChains; my $driver = Selenium::Remote::Driver->new; my $action_chains = Selenium::ActionChains->new(driver => $driver); $driver->get("http://www.some.web/site"); my $elt_1 = $driver->find_element("//*[\@id='someid']"); my $elt_2 = $driver->find_element("//*[\@id='someotherid']"); $action_chains->send_keys_to_element($elt_1)->click($elt_2)->perform;
This module implements ActionChains for Selenium, which is a way of automating low level interactions like mouse movements, mouse button actions , key presses and context menu interactions. The code was inspired by the Python implementation.
The implementation contains a drag_and_drop function, but due to Selenium limitations, it is not working.
Nevertheless, we decided to implement the function, because eventually one day it will work.
In the meantime, there are workarounds that can be used to simulate drag and drop, like this StackOverflow post.
Creates a new ActionChains object. Requires a Selenium::Remote::Driver as a mandatory parameter:
my $driver = Selenium::Remote::Driver->new; my $action_chains = Selenium::ActionChains->new(driver => $driver);
Performs all the actions stored in the ActionChains object in the order they were called:
Args: None Usage: my $action_chains = Selenium::ActionChains->new(driver => $driver); # assuming that $some_element and $other_element are valid # Selenium::Remote::WebElement objects $action_chains->click($some_element); $action_chains->move_to_element($other_element); $action_chains->click($other_element); # click some_element, move to other_element, then click other_element $action_chains->perform;
Clicks an element. If none specified, clicks on current mouse position.
Args: A Selenium::Remote::WebElement object Usage: my $element = $driver->find_element("//div[\@id='some_id']"); $action_chains->click($element);
Holds down the left mouse button on an element. If none specified, clicks on current mouse position.
Args: A Selenium::Remote::WebElement object Usage: my $element = $driver->find_element("//div[\@id='some_id']"); $action_chains->click_and_hold($element);
Right clicks an element. If none specified, right clicks on current mouse position.
Args: A Selenium::Remote::WebElement object Usage: my $element = $driver->find_element("//div[\@id='some_id']"); $action_chains->context_click($element);
Double clicks an element. If none specified, double clicks on current mouse position.
Args: A Selenium::Remote::WebElement object Usage: my $element = $driver->find_element("//div[\@id='some_id']"); $action_chains->double_click($element);
Holds down the left mouse button on the source element, then moves to the target element and releases the mouse button. IT IS NOT WORKING DUE TO CURRENT SELENIUM LIMITATIONS.
Args: A source Selenium::Remote::WebElement object A target Selenium::Remote::WebElement object Usage: my $src_element = $driver->find_element("//*[\@class='foo']"); my $tgt_element = $driver->find_element("//*[\@class='bar']"); $action_chains->drag_and_drop($src_element,$tgt_element);
Holds down the left mouse button on the source element, then moves to the offset specified and releases the mouse button. IT IS NOT WORKING DUE TO CURRENT SELENIUM LIMITATIONS.
Args: A source Selenium::Remote::WebElement object An integer X offset An integer Y offset Usage: my $src_element = $driver->find_element("//*[\@class='foo']"); my $xoffset = 10; my $yoffset = 10; $action_chains->drag_and_drop($src_element,$xoffset,$yoffset);
Sends key presses only, without releasing them. Should be used only with modifier keys (Control, Alt, Shift)
Args: An array ref to keys to send. Use the KEY constant from Selenium::Remote::WDKeys The element to send keys to. If none, sends keys to the current focused element Usage: use Selenium::Remote::WDKeys 'KEYS'; $action_chains->key_down( [ KEYS->{'alt'} ] );
Releases a mofifier key.
Args: An array ref to keys to send. Use the KEY constant from Selenium::Remote::WDKeys The element to send keys to. If none, sends keys to the current focused element Usage: use Selenium::Remote::WDKeys 'KEYS'; my $element = $driver->find_element('foo','id'); $action_chains->key_up( [ KEYS->{'alt'} ],$element);
Moves the mouse to an offset from current mouse position.
Args: An integer X offset An integer Y offset Usage: $action_chains->move_by_offset(10,100);
Moves the mouse to the middle of an element
Args: A Selenium::Remote::WebElement to move to Usage: my $element = $driver->find_element('foo','id'); $action_chains->move_to_element($element);
Moves the mouse by an offset of the specified element. Offsets are relative to the top-left corner of the element
Args: A Selenium::Remote::WebElement An integer X offset An integer Y offset Usage: my $element = $driver->find_element('foo','id'); $action_chains->move_to_element_with_offset($element,10,10);
Releases a held mouse_button
Args: A Selenium::Remote::WebElement, the element to mouse up Usage: my $element = $driver->find_element('foo','id'); $action_chains->release($element);
Sends keys to the currently focused element
Args: The keys to send Usage: $action_chains->send_keys('abcd');
Sends keys to an element
Args: A Selenium::Remote::WebElement The keys to send Usage: my $element = $driver->find_element('foo','id'); $action_chains->send_keys_to_element($element,'abcd');
Please see those modules/websites for more information related to this module.
Selenium::Remote::Driver
Please report any bugs or feature requests on the bugtracker website https://github.com/teodesian/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.
Current Maintainers:
Daniel Gempesaw <gempesaw@gmail.com>
Emmanuel Peroumalnaïk <peroumalnaik.emmanuel@gmail.com>
Previous maintainers:
Luke Closs <cpan@5thplane.com>
Mark Stosberg <mark@stosberg.com>
Original authors:
Aditya Ivaturi <ivaturi@gmail.com>
Copyright (c) 2010-2011 Aditya Ivaturi, Gordon Child
Copyright (c) 2014-2017 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.