Commands for Element
We will now be detailing about the various commands to find element with illustrations. Further, these examples showcasing different type of commands to find elements are used in Java.
TYPE 1 – Commands for Element – Commands to Find Element
1. Find Element
This command is used to search for an element on the page. In which case, you will get the first element that matches a locator strategy.
Example –
MobileElement elementOne = (MobileElement) driver.findElementByAccessibilityId(“SomeAccessibilityID”);
MobileElement elementTwo = (MobileElement) driver.findElementByClassName(“SomeClassName”);
HTTP API Specifications
Endpoint – POST /wd/hub/session/:session_id/element
URL Parameters –
- session_id ID of the session to route the command to
JSON Parameters –
| name | type | description |
| using | string | The locator strategy to use |
| value | string | The search target |
Response – A JSON object for the located element (object)
2. Find Elements
This is primarily used to search for multiple elements. Further it is used to get a list of elements that match the locator selector.
Example –
List<MobileElement> elementsOne = (MobileElement) driver.findElementsByAccessibilityId(“SomeAccessibilityID”);
List<MobileElement> elementsTwo = (MobileElement) driver.findElementsByClassName(“SomeClassName”);
HTTP API Specifications
Endpoint – POST /wd/hub/session/:session_id/elements
URL Parameters –
- session_id ID of the session to route the command to
JSON Parameters –
| name | type | description |
| using | string | The locator strategy to use |
| value | string | The search target |
Response – A list of JSON objects for the located elements (Array<String>)
TYPE 2 Commands for Element – Commands for Actions
1. Click
When you click element at its center point, then the element’s center point is obscured by another element. Such that element click intercepted error is returned.
Example –
MobileElement el = driver.findElementByAccessibilityId(“SomeId”);
el.click();
HTTP API Specifications
Endpoint – POST /wd/hub/session/:session_id/element/:element_id/click
URL Parameters –
- session_id UUID of the session
- element_id UUID of the element
JSON Parameters – None
Response – null
2. Send Keys
This command is used to send a sequence of key strokes to an element.
Example –
MobileElement element = (MobileElement) driver.findElementByAccessibilityId(“SomeAccessibilityID”);
element.sendKeys(“Hello world!”);
HTTP API Specifications
Endpoint – POST /wd/hub/session/:session_id/element/:element_id/value
URL Parameters –
- session_id ID of the session to route the command to
- element_id ID of the element to send keys to.
JSON Parameters –
| name | type | description |
| value | array<string> | The sequence of keys to type. An array must be provided. The server should flatten the array items to a single string to be typed. |
Response -null
TYPE 3 – Attribute Commands
1. Get Element Text
This is the first type of Attribute command used to return the visible text for the element.
Example –
MobileElement element = (MobileElement) driver.findElementByClassName(“SomeClassName”);
String elText = element.getText();
HTTP API Specifications
Endpoint – GET /wd/hub/session/:session_id/element/:element_id/text
URL Parameters –
- session_id ID of the session to route the command to
- element_id ID of the element to get the text from
JSON Parameters – None
Response – null
2. Get Tag Name
This the second type of attribute command used to get an element’s tag name.
Example –
List<MobileElement> element = (MobileElement) driver.findElementByAccessibilityId(“SomeAccessibilityID”);
String tagName = element.getTagName();
HTTP API Specifications
Endpoint – GET /wd/hub/session/:session_id/elements/:element_id/name
URL Parameters –
- session_id ID of the session to route the command to
- element_id ID of the element to get the name from
JSON Parameters – None
Response -The tag name of the element (string)
