wtf-util

What is WTF Util?

The WTF Util is a collection of util methods for writing webdriver tests on Java. These util methods will makes the webdriver testing on browsers more reliable, easier and stable.

Util method pattern

All our util methods supports 4 unique method patterns. All 4 variations does the same thing but it provides options like explicit wait condition to use, options to pass parent element to isolate or minimize the DOM lookup etc..

1. utilMethodName(Webdriver driver, By by);
2. utilMethodName(Webdriver driver, WebdriverWait wait, By by);
3. utilMethodName(Webdriver, WebElement ParenetElement, By by);
4. utilMethodName(Webdriver driver, WebdriverWait wait,  WebElement ParenetElement, By by);

Util Methods

• attributeValuePresent
• clear
• click
• findElement
• findElements
• getAttributeValue
• getSelectElement
• getText
• getValue
• hover
• invisible
• notPresent
• notSelected
• present
• selected
• textNotPresent
• textPresent
• type
• visible

Start using in your Webdriver project ( Maven Repo. and Deps. )

 <repositories>
     <repository>
         <id>my-repo</id>
         <url>https://github.com/web-auto/wtf-maven-repo/raw/master/releases</url>
     </repository>
 </repositories>


  <dependencies>
    <dependency>
      <groupId>org.wtf</groupId>
      <artifactId>wtf-util</artifactId>
      <version>1.0.0</version>
    </dependency>
  </dependencies>

### AttributeValuePresent ###### attributeValuePresent(driver, by, attr, value) ###### attributeValuePresent(driver, wait, by, attr, value) ###### attributeValuePresent(driver, parent, by, attr, value) ###### attributeValuePresent(driver, wait, parent, by, attr, value)

Find and return boolean if the given attr name and value found on element using the given by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance
• attr - The attribut to lookup
• value - The value to match

Example

public void testAttributeValuePresent() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Assert.assertTrue(WTFUtil.attributeValuePresent(driver, By.className("some-class-name"),
                    "myattr", "my-attr-value"));
}

---

### Clear ###### clear(driver, by) ###### clear(driver, wait, by) ###### clear(driver, parent, by) ###### clear(driver, wait, parent, by)

Clear the text field element using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testClear() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  WTFUtil.clear(driver, By.className("some-class-name"));
}

---

### Click ###### click(driver, by) ###### click(driver, wait, by) ###### click(driver, parent, by) ###### click(driver, wait, parent, by)

Click on an element using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testClick() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  WTFUtil.click(driver, By.className("some-class-name"));
}

---

### FindElement ###### findElement(driver, by) ###### findElement(driver, wait, by) ###### findElement(driver, parent, by) ###### findElement(driver, wait, parent, by)

Find and returns a WebElement using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testFindElement() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  WebElement webElement = WTFUtil.findElement(driver, By.className("some-class-name"));
}

---

### FindElements ###### findElements(driver, by) ###### findElements(driver, wait, by) ###### findElements(driver, parent, by) ###### findElements(driver, wait, parent, by)

Find and returns a list of WebElement using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testFindElements() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  WebElement [] webElements = WTFUtil.findElements(driver, By.className("some-class-name"));
}

---

### GetAttributeValue ###### getAttributeValue(driver, by, attr) ###### getAttributeValue(driver, wait, by, attr) ###### getAttributeValue(driver, parent, by, attr) ###### getAttributeValue(driver, wait, parent, by, attr)

Find and returns an attrubute value for the given attribute name on a WebElement using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance
• attr - An attribut to find

Example

public void testGetAttributeValue() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  String attrVal = WTFUtil.getAttributeValue(driver, By.className("some-class-name"), "some-attribute");
}

---

### GetSelectElement ###### getSelectElement(driver, by) ###### getSelectElement(driver, wait, by) ###### getSelectElement(driver, parent, by) ###### getSelectElement(driver, wait, parent, by)

Find and returns the Webdriver Select object using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testGetSelectElement() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Select select = WTFUtil.getSelectElement(driver, By.className("some-class-name"));
}

---

### GetText ###### getText(driver, by) ###### getText(driver, wait, by) ###### getText(driver, parent, by) ###### getText(driver, wait, parent, by)

Returns the text value of an element using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testGetText() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  String text = WTFUtil.getText(driver, By.className("some-class-name"));
}

---

### GetValue ###### getValue(driver, by) ###### getValue(driver, wait, by) ###### getValue(driver, parent, by) ###### getValue(driver, wait, parent, by)

Returns the value from an element using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testValue() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  String value = WTFUtil.getValue(driver, By.className("some-class-name"));
}

---

### Hover ###### hover(driver, by) ###### hover(driver, wait, by) ###### hover(driver, parent, by) ###### hover(driver, wait, parent, by)

Hover on an element using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testHover() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  WTFUtil.hover(driver, By.className("some-class-name"));
}

---

### Invisible ###### invisible(driver, by) ###### invisible(driver, wait, by) ###### invisible(driver, parent, by) ###### invisible(driver, wait, parent, by)

Returns boolean if an element is not visible using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testInvisible() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Boolean inVisible = WTFUtil.invisible(driver, By.className("some-class-name"));
}

---

### NotPresent ###### notPresent(driver, by) ###### notPresent(driver, wait, by) ###### notPresent(driver, parent, by) ###### notPresent(driver, wait, parent, by)

Determines the given element is not present on the DOM using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testNotPresent() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Boolean visible = WTFUtil.notPresent(driver, By.className("some-class-name"));
}

---

### NotSelected ###### notSelected(driver, by) ###### notSelected(driver, wait, by) ###### notSelected(driver, parent, by) ###### notSelected(driver, wait, parent, by)

Determines the given item is not selected yet on a Select WebElement using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testNotSelected() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Boolean notSlected = WTFUtil.notSelected(driver, By.className("some-class-name"));
}

---

### Present ###### present(driver, by) ###### present(driver, wait, by) ###### present(driver, parent, by) ###### present(driver, wait, parent, by)

Determines the WebElement is present on DOM using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testPresent() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Boolean visible = WTFUtil.present(driver, By.className("some-class-name"));
}

---

### Selected ###### selected(driver, by) ###### selected(driver, wait, by) ###### selected(driver, parent, by) ###### selected(driver, wait, parent, by)

Determines the given item is selected yet on a Select WebElement using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testSelected() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Boolean selected = WTFUtil.notSelected(driver, By.className("some-class-name"));
}

---

### TextNotPresent ###### textNotPresent(driver, by, text) ###### textNotPresent(driver, wait, by, text) ###### textNotPresent(driver, parent, by, text) ###### textNotPresent(driver, wait, parent, by, text)

Determines the given text is not present on the WebElement using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance
• text - A Webdriver By instance

Example

public void testTextNotPresent() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Boolean textPresent = WTFUtil.TextNotPresent(driver, By.className("some-class-name"), "some text");
}

---

### TextPresent ###### textPresent(driver, by, text) ###### textPresent(driver, wait, by, text) ###### textPresent(driver, parent, by, text) ###### textPresent(driver, wait, parent, by, text)

Determines the given text is present on the WebElement using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance
• text - A Webdriver By instance

Example

public void testTextPresent() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Boolean textPresent = WTFUtil.notSelected(driver, By.className("some-class-name"), "some text");
}

---

### Type ###### type(driver, by, text) ###### type(driver, wait, by, text) ###### type(driver, parent, by, text) ###### type(driver, wait, parent, by, text)

Types the give text on a WebElement using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance
• text - A Webdriver By instance

Example

public void testType() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  WTFUtil.type(driver, By.className("some-class-name"), "some text..");
}

---

### Visible ###### visible(driver, by) ###### visible(driver, wait, by) ###### visible(driver, parent, by) ###### visible(driver, wait, parent, by)

Returns boolean if an element is visible using by.

Arguments

• driver - An instance of Webdriver
• wait - An instance of WebdriverWait (optional)
• parent - The parent element to look in (optional)
• by - A Webdriver By instance

Example

public void testVisible() {
  Webdriver driver = new FirefoxDriver();
  driver.get("http://www.example.com");
  Boolean visible = WTFUtil.visible(driver, By.className("some-class-name"));
}

---

Team

• Author & Lead Maintainer: Venkat Sundramurthy
• Contributors:
  • Vineet Kothari
  • Vikram

License

MIT