Table of contents

Contents



Official Content

Keystroke commands are used to send single Keys to some UI control, typically to force running some JS events on the webpage after pressing a special key. 

See the list of special characters to use.

Note: 
While sending a key {Tab} is a common practice for some automated tests we recommend to use it only when there is no other alternative (like clicking or typing somewhere else to lost focus, etc), since browser implementation of this could lead to flaky results. Also, while this function enables us to send characters to the UI, it is not intended to be used for typing. For typing over text fields use type commands instead.

SendKeys

This command allows you to send keys to the browser and controls.

There are 3 implementations of this command:

Sends keys to a specific control
SendKeys2_png

Sends keys to a specific control inside a grid

SendKeysGrid_png

Sends keys to the currently focused element or the page itself if there is none.
SendKeys1_png

Parameters:

  • ControlName: name of the control to send the Keys
  • Row: row number to locate the element to send the keys to.
  • Keys: keys to send. It's recommended to use the "Keys" domain to send special keys like ENTER, TAB, ESC, etc.. They can be combined using the character | as keys separator.

Can be used to confirm a form (Keys.Enter), to move over combo box options (Keys.DOWN and Keys.UP), navigate web elements (Keys.TAB), etc.

Examples:

&driver.SendKeys("optionsCtrl", Keys.DOWN)

&driver.SendKeys(Keys.Enter) 

&driver.SendKeys("someControl", 1, Keys.Enter)

&driver.SendKeys(Keys.CONTROL + "|a") // This will send the command Ctrl + A to the currently focused element or the whole webpage if none is focused

&driver.SendKeys(Keys.TAB)

KeysByID

image_20181210124932_1_png

Sends keys using the ID attribute.

Parameters:

  • ID: the HTML element ID to send the key.
  • Text: Character(s) to send. 

Example of use: 

&driver.KeysByID("vSUG1", "{BACKSPACE}")

KeysByName

image_20181210125051_1_png

Sends keys using the 'name' attribute.

Parameters:

  • Name: the name attribute of the element to send the key.
  • Text: Character(s) to send. 

Example of use: 

&driver.KeysByName("vSUG1", "{TAB}")

KeysByCSS

image_20181210125830_1_png

Sends keys using a CSS selector.

Parameters:

  • CSS: the CSS locator of the element to send the key.
  • Text: Character(s) to send. 

Example of use: 

&driver.KeysByCss("#vSUG1", "u")

KeysByXPath

image_2018121012592_1_png

Sends keys using an XPath selector.

Parameters:

  • XPath: the XPath of the element to send the key.
  • Text: Character(s) to send. 

Example of use: 

&driver.KeysByXpath("//input[@id='vSUG2']", "{RETURN}")


Last update: February 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant