# UI Action Methods

## Assertion methods

In testing context, assertions make sure the product has met the expectations. QATTS gives you various useful and simple methods to run assertions.

1. State Check
2. Assert HTML Elements
3. Assert Product Elements
4. Assert Groups

### State Check

***stateCheck*** is a feature to know whether the execution control landed on the intended page. This method requires three parameters.

#### Syntax

***void stateCheck(String htmlElementName, String attType,String targetValue)***

| **Name**              | **Type** | **Description**                      |
| --------------------- | -------- | ------------------------------------ |
| ***htmlElementName*** | String   | Dom element name                     |
| **attType**           | String   | Type of the attribute                |
| ***targetValue***     | String   | The actual value of the html element |

#### Code snippet

```
/* 
 *  "I'm Feeling Lucky" button is found on Google's home page, 
 *  which tells you that you are rightly landed on Google's 
 *  home page
 */

stateCheck("bt.iamfeelinglucky", "value", "I'm Feeling Lucky");
```

### Assert HTML Element

***assertElement*** method compares the actual value of a html element name with the expected target value. Here the ***attType*** param gives additional information about the html element on with the assertion has to be made.

#### ***Syntax***

***boolean assertElement(String htmlElementName, String attType, String targetValue)***

| **Name**              | **Type** | **Description**                      |
| --------------------- | -------- | ------------------------------------ |
| ***htmlElementName*** | String   | HTML element name                    |
| ***attType***         | String   | Type of the attribute                |
| ***targetValue***     | String   | The actual value of the html element |

#### Code snippet

```
/*
 * Comparing the firstresult of Google search with "https://qatts.com/"
 */

assertElement("li.firstresult", "href","https://qatts.com/");
```

### Assert Product Elements

***assertField*** methods compares the actual value of the Product element with the expected value. There are two method variants in this category. The first method with additional param ***Object objectValue*** can used when you know exact expected value or the expected value is expected to be from previous test result. 

The latter method will perform assertion from the test data found in the excel sheet.

#### Syntax

1. ***boolean assertField( String prodElementName, String elementType, Object objectValue)***
2. ***boolean assertField( String prodElementName, String elementType)***

| **Name**              | **Type** | **Description**                               |
| --------------------- | -------- | --------------------------------------------- |
| ***prodElementName*** | String   | Dom element name                              |
| ***elementType***     | String   | Type of the UI element. \[input, view, error] |
| ***objectValue***     | Object   | The actual value                              |

### Assert Groups

Group assertion is similar to the above element assertion. The only difference is you will be doing assertion on a group. All the Product element under the given group will be asserted in a single go. By setting ***recursive,*** Qatts will find all the product elements under the group by continuously looping through subgroups. 

#### Syntax

1. ***boolean assertGroup(String groupName,String elementType)***
2. ***boolean assertGroup(String groupName, String elementType, boolean recursive)***

| **Name**          | **Type** | **Description**                               |
| ----------------- | -------- | --------------------------------------------- |
| ***groupName***   | String   | Name of the group                             |
| ***elementType*** | String   | Type of the UI element. \[input, view, error] |
| ***recursive***   | boolean  | TRUE or FALSE                                 |

## Data population methods

Automation process requires loading of test data from the data repository. QATTS has couple of data loading methods that assist in test automation process. These methods work on Product Elements.

### Populate Field

***populateField*** method is used to populate the UI element with the test data. 

#### ***Syntax***

1. ***void***** populateField*****( String elementName)***
2. ***void populateField( String elementName, Object objectValue)***

| **Name**          | **Type** | **Description**        |
| ----------------- | -------- | ---------------------- |
| ***elementName*** | String   | Name of the group      |
| ***objectValue*** | Object   | The value to be search |

#### Code Snippet

```
/*
 *
 */
populateField("SearchText", "Apple");
```

### Populate Group

void populateGroup( String groupName)

void populateGroup( String groupName,boolean recursive)

### Populate Alert

void populateAlert(String productElement)

## Link methods

### Extract Links

List extractLinks(String url, String productElement)

List extractLinks(String productElement)

### Check Broken Link

Map checkBrokenLink(String url)

## Other UI action Methods

### Perform Named Action

void performNamedAction( String actionName)

### Perform Field Level Actions

void performFieldLevelAction(String sectionName)

### Perform Element Checks

void performElementChecks( String sectionName)

### Perform Page Checks

void performPageChecks(String productElement)

### Wait  for invisibility of element

boolean waitForInvisibilityOfElement(String htmlElementName)

### Get table data

List> getTableData(String UIElement)

### Refresh page

void refreshPage(String url)

### Alert action

void alertAction(String htmlElement, String data)

### Get element size

int getElementSize(String htmlElementName)

boolean contains(String htmlElementName, String attType,String targetValue)

boolean containsElement(String htmlElementName)

boolean containsText(String findText)

Map extractGroup( String groupName,String elementType)

Map extractGroup( String groupName,String elementType,boolean recursive)

QArray extractTableData(String htmlElementName)

String getErrorMsg(String elementName)

String getText(String htmlElementName)

String getAttribute(String htmlElementName,String attName)

List getAttributesAsList(String htmlElementName)

void clearField(String elementName)

boolean mouseOver( String elementName)

boolean mouseOverAndClick( String elementName)

boolean mouseOverIf( String elementName)

boolean mouseOverAndClickIf( String elementName)

void switchWindow(Integer windowNo)

void switchWindow(String windowName)

void switchToFrame(String nameOrId)

void switchToDefaultFrame()

void closeWindow(Object window)

boolean clickIf( String elementName)

boolean click( String elementName)

void takeScreenShot(String labelName)

void checkW3(String url)

void checkW3()

void checkAccessibility()

void checkAccessibility(String url)

void checkAccessibility(String url,String uAgent)

void checkAccessibility(String url, boolean uAgent)

Object getUserInput(String ...attName)