Method: Selenium::WebDriver::KeyActions#key_down

Defined in:
lib/selenium/webdriver/common/interactions/key_actions.rb

#key_down(key, device: nil) ⇒ ActionBuilder #key_down(element, key, device: nil) ⇒ ActionBuilder

Performs a key press. Does not release the key - subsequent interactions may assume it’s kept pressed. Note that the key is never released implicitly - either ActionBuilder#key_up(key) or ActionBuilder#release_actions must be called to release the key.

Examples:

Press a key


driver.action.key_down(:control).perform

Press a key on an element


el = driver.find_element(id: "some_id")
driver.action.key_down(el, :shift).perform

Overloads:

  • #key_down(key, device: nil) ⇒ ActionBuilder

    Parameters:

    • key (Symbol, String) —

      The key to press

    • device (Symbol, String) (defaults to: nil) —

      Optional name of the KeyInput device to press the key on

  • #key_down(element, key, device: nil) ⇒ ActionBuilder

    Parameters:

    • element (Element) —

      An optional element to move to first

    • key (Symbol, String) —

      The key to press

    • device (Symbol, String) (defaults to: nil) —

      Optional name of the KeyInput device to press the key on

Returns:



47
48
49
 
# File 'lib/selenium/webdriver/common/interactions/key_actions.rb', line 47

def key_down(*, device: nil)
  key_action(*, action: :create_key_down, device: device)
end