InBrowser (DollarX - Java version 0.39 API)

java.lang.Object
- com.github.loyada.jdollarx.InBrowser

```
public class InBrowser
extends Object
```
A wrapper around Selenium WebDriver, used for interaction with the browser. In case only a single instance of the browser is used, InBrowserSinglton offers a simpler API.

Constructor Summary

Constructors
Constructor and Description

InBrowser(org.openqa.selenium.WebDriver driver)
Creates a connection to a browser, using the given driver

Constructors
Constructor and Description
`InBrowser(org.openqa.selenium.WebDriver driver)` Creates a connection to a browser, using the given driver

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`org.openqa.selenium.WebElement`	`clickAt(Path el)` Click at the location the first element that fits the given path.
`org.openqa.selenium.WebElement`	`clickOn(Path el)` Click on the first element that fits the given path.
`void`	`doubleClickOn(Path el)` Doubleclick the location of the first element that fits the given path
`Operations.DragAndDrop`	`dragAndDrop(Path path)` Drag and drop in the browser.
`org.openqa.selenium.WebElement`	`find(Path el)` Finds an element in the browser, based on the xpath representing el.
`List<org.openqa.selenium.WebElement>`	`findAll(Path el)` Finds all elements in the browser, based on the xpath representing el.
`org.openqa.selenium.WebElement`	`findPageWithNumberOfOccurrences(Path el, int numberOfOccurrences, RelationOperator relationOperator)` Don't use this directly.
`org.openqa.selenium.WebElement`	`findPageWithout(Path el)` Finds an page in the browser, that does not contain the given path
`org.openqa.selenium.WebDriver`	`getDriver()`
`org.openqa.selenium.WebElement`	`hoverOver(Path el)` Hover over the location of the first element that fits the given path
`boolean`	`isDisplayed(Path el)` is the element present and displayed? Typically you should not use this method directly.
`boolean`	`isEnabled(Path el)` is the element present and enabled? Typically you should not use this method directly.
`boolean`	`isNotPresent(Path el)` is the element present? Typically you should not use this method directly.
`boolean`	`isPresent(Path el)` is the element present? Typically you should not use this method directly.
`boolean`	`isSelected(Path el)` is the element present and selected? Typically you should not use this method directly.
`Integer`	`numberOfAppearances(Path el)` Returns the number of elements in the browser that match the given path.
`Operations.KeysDown`	`pressKeyDown(CharSequence thekey)` Press key down in the browser, or on a specific element.
`Operations.ReleaseKey`	`releaseKey(CharSequence thekey)` Release key down in the browser, or on a specific element.
`Operations.Scroll`	`scroll()` scroll the browser.
`Operations.ScrollElement`	`scrollElement(Path wrapper)`
`org.openqa.selenium.WebElement`	`scrollTo(Path el)` Scroll to the location of the first element that fits the given path
`Operations.KeysSender`	`sendKeys(CharSequence... charsToSend)` send keys to the browser, or to a specific element.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - InBrowser
```
public InBrowser(org.openqa.selenium.WebDriver driver)
```
    Creates a connection to a browser, using the given driver
    
    Parameters:
    
    driver - a WebDriver instance
- Method Detail
  - getDriver
```
public org.openqa.selenium.WebDriver getDriver()
```
    Returns:
    
    the underlying WebDriver instance
  - find
```
public org.openqa.selenium.WebElement find(Path el)
```
    Finds an element in the browser, based on the xpath representing el. It is similar to WebDriver.findElement(), If el also has a WebElement (ie: getUnderlyingSource() is not empty), then it looks inside that WebElement. This is useful also to integrate with existing WebDriver code.
    
    Parameters:
    
    el - - the path to find
    
    Returns:
    
    - A WebElement instance from selenium, or throws NoSuchElementException exception
  - findPageWithNumberOfOccurrences
```
public org.openqa.selenium.WebElement findPageWithNumberOfOccurrences(Path el,
                                                                      int numberOfOccurrences,
                                                                      RelationOperator relationOperator)
```
    Don't use this directly. There are better ways to do equivalent operation.
    
    Parameters:
    
    el - the path to find
    
    numberOfOccurrences - the base number to find
    
    relationOperator - whether we look for exactly the numberOfOccurrences, at least, or at most occurrences
    
    Returns:
    
    the first WebElement found
  - findPageWithout
```
public org.openqa.selenium.WebElement findPageWithout(Path el)
```
    Finds an page in the browser, that does not contain the given path
    
    Parameters:
    
    el - - the path that must not appear in the page
    
    Returns:
    
    returns the page element or raises NoSuchElementException
  - findAll
```
public List<org.openqa.selenium.WebElement> findAll(Path el)
```
    Finds all elements in the browser, based on the xpath representing el. It is similar to WebDriver.findElements(), If el also has a WebElement (ie: getUnderlyingSource() is not empty), then it looks inside that WebElement. This is useful also to integrate with existing WebDriver code.
    
    Parameters:
    
    el - - the path to find
    
    Returns:
    
    - A list of WebElement from selenium, or throws NoSuchElementException exception
  - numberOfAppearances
```
public Integer numberOfAppearances(Path el)
```
    Returns the number of elements in the browser that match the given path. Typically you should not use this method directly. Instead, use CustomMatchers.
    
    Parameters:
    
    el - the element to find
    
    Returns:
    
    the number of elements in the browser that match the given path
  - isPresent
```
public boolean isPresent(Path el)
```
    is the element present? Typically you should not use this method directly. Instead, use CustomMatchers.
    
    Parameters:
    
    el - the path to find
    
    Returns:
    
    true if the element is present
  - isNotPresent
```
public boolean isNotPresent(Path el)
```
    is the element present? Typically you should not use this method directly. Instead, use CustomMatchers.
    
    Parameters:
    
    el - the path to find
    
    Returns:
    
    true if it is not present
  - isEnabled
```
public boolean isEnabled(Path el)
```
    is the element present and enabled? Typically you should not use this method directly. Instead, use CustomMatchers.
    
    Parameters:
    
    el - the element
    
    Returns:
    
    true if it is present and enabled
  - isSelected
```
public boolean isSelected(Path el)
```
    is the element present and selected? Typically you should not use this method directly. Instead, use CustomMatchers.
    
    Parameters:
    
    el - the element
    
    Returns:
    
    true if it is present and selected
  - isDisplayed
```
public boolean isDisplayed(Path el)
```
    is the element present and displayed? Typically you should not use this method directly. Instead, use CustomMatchers. Also, this is limited to checking the inlined css style, so it is quite limited.
    
    Parameters:
    
    el - the element
    
    Returns:
    
    true if it is present and selected
  - clickOn
```
public org.openqa.selenium.WebElement clickOn(Path el)
```
    Click on the first element that fits the given path. Only works for clickable elements.
    
    Parameters:
    
    el - the element
    
    Returns:
    
    the clicked on WebElement
  - clickAt
```
public org.openqa.selenium.WebElement clickAt(Path el)
```
    Click at the location the first element that fits the given path. Does not require a clickable element.
    
    Parameters:
    
    el - the element
    
    Returns:
    
    the clicked on WebElement
  - hoverOver
```
public org.openqa.selenium.WebElement hoverOver(Path el)
```
    Hover over the location of the first element that fits the given path
    
    Parameters:
    
    el - the element
    
    Returns:
    
    the clicked on WebElement
  - scrollTo
```
public org.openqa.selenium.WebElement scrollTo(Path el)
```
    Scroll to the location of the first element that fits the given path
    
    Parameters:
    
    el - the element
    
    Returns:
    
    the clicked on WebElement
  - doubleClickOn
```
public void doubleClickOn(Path el)
```
    Doubleclick the location of the first element that fits the given path
    
    Parameters:
    
    el - the element
  - sendKeys
```
public Operations.KeysSender sendKeys(CharSequence... charsToSend)
```
    send keys to the browser, or to a specific element. Two flavors of use: browser.sendKeys("abc").toBrowser(); browser.sendKeys("abc").to(path);
    
    Parameters:
    
    charsToSend - The characters to send. Can be "abc" or "a", "b", "c"
    
    Returns:
    
    a KeySender instance that allows to send keys to the browser in general, or to a specific DOM element
  - pressKeyDown
```
public Operations.KeysDown pressKeyDown(CharSequence thekey)
```
    Press key down in the browser, or on a specific element. Two flavors of use: browser.pressKeyDown(Keys.TAB).inBrowser(); browser.pressKeyDown(Keys.TAB).on(path);
    
    Parameters:
    
    thekey - a key to press
    
    Returns:
    
    returns a KeysDown instance that allows to press a key on the browser in general or on a specific DOM element
  - releaseKey
```
public Operations.ReleaseKey releaseKey(CharSequence thekey)
```
    Release key down in the browser, or on a specific element. Two flavors of use:
```
 
    browser.releaseKey(Keys.TAB).inBrowser();
    browser.releaseKey(Keys.TAB).on(path);
 
 
```
    Parameters:
    
    thekey - a key to release
    
    Returns:
    
    returns a ReleaseKey instance that allows to release on the browser in general or on a specific DOM element
  - scroll
```
public Operations.Scroll scroll()
```
    scroll the browser. Several flavors of use:
```
 
    browser.scroll().to(path);
    browser.scroll().left(50);
    browser.scroll().right(50);
    browser.scroll().up(50);
    browser.scroll().down(50);
 
 
```
    Returns:
    
    a Scroll instance that allows to scroll by offset or to a location of a DOM element
  - scrollElement
```
public Operations.ScrollElement scrollElement(Path wrapper)
```
  - dragAndDrop
```
public Operations.DragAndDrop dragAndDrop(Path path)
```
    Drag and drop in the browser. Several flavors of use: browser.dragAndDrop(source).to(target); browser.dragAndDrop(source).to(xCor, yCor);
    
    Parameters:
    
    path - the source element
    
    Returns:
    
    a DragAndDrop instance, that allows to drag and drop to a location or to another DOM element

Class InBrowser

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

InBrowser

Method Detail

getDriver

find

findPageWithNumberOfOccurrences

findPageWithout

findAll

numberOfAppearances

isPresent

isNotPresent

isEnabled

isSelected

isDisplayed

clickOn

clickAt

hoverOver

scrollTo

doubleClickOn

sendKeys

pressKeyDown

releaseKey

scroll

scrollElement

dragAndDrop