ru.yandex.qatools.htmlelements.element

Class Table

java.lang.Object

ru.yandex.qatools.htmlelements.element.TypifiedElement

ru.yandex.qatools.htmlelements.element.Table

All Implemented Interfaces:

org.openqa.selenium.SearchContext, org.openqa.selenium.TakesScreenshot, org.openqa.selenium.WebElement, org.openqa.selenium.WrapsElement, Named

public class Table
extends TypifiedElement

Represents web page table element. Provides convenient ways of retrieving data stored in it.

Author:

Alexander Tolmachev starlight@yandex-team.ru Date: 11.03.13

Constructor Summary

Constructors

Constructor and Description
Table(org.openqa.selenium.WebElement wrappedElement) Specifies WebElement representing table tag.

Method Summary

Modifier and Type	Method and Description
org.openqa.selenium.WebElement	getCellAt(int i, int j) Returns table cell element (<td>), at i-th row and j-th column.
List<org.openqa.selenium.WebElement>	getColumnByIndex(int index) Returns table cell elements (<td>), of a particular column.
List<List<org.openqa.selenium.WebElement>>	getColumns() Returns table cell elements (<td>), grouped by columns.
List<List<String>>	getColumnsAsString() Returns text values of table cell elements (<td>), grouped by columns.
List<org.openqa.selenium.WebElement>	getHeadings() Returns a list of table heading elements (<th>).
List<String>	getHeadingsAsString() Returns text values of table heading elements (contained in "th" tags).
List<List<org.openqa.selenium.WebElement>>	getRows() Returns table cell elements (<td>), grouped by rows.
List<List<String>>	getRowsAsString() Returns text values of table cell elements (<td>), grouped by rows.
List<Map<String,String>>	getRowsAsStringMappedToHeadings() Same as getRowsMappedToHeadings() but retrieves text from row elements (<td>).
List<Map<String,String>>	getRowsAsStringMappedToHeadings(List<String> headings) Same as getRowsMappedToHeadings(java.util.List) but retrieves text from row elements (<td>).
List<Map<String,org.openqa.selenium.WebElement>>	getRowsMappedToHeadings() Returns list of maps where keys are table headings and values are table row elements (<td>).
List<Map<String,org.openqa.selenium.WebElement>>	getRowsMappedToHeadings(List<String> headings) Returns list of maps where keys are passed headings and values are table row elements (<td>),.

Methods inherited from class ru.yandex.qatools.htmlelements.element.TypifiedElement

clear, click, exists, findElement, findElements, getAttribute, getCssValue, getLocation, getName, getRect, getScreenshotAs, getSize, getTagName, getText, getWrappedElement, isDisplayed, isEnabled, isSelected, sendKeys, setName, submit, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openqa.selenium.WebElement

getAccessibleName, getAriaRole, getDomAttribute, getDomProperty, getShadowRoot

Constructor Detail

Table

public Table(org.openqa.selenium.WebElement wrappedElement)

Specifies WebElement representing table tag.

Parameters:

wrappedElement - WebElement to wrap.

Method Detail

getHeadings

public List<org.openqa.selenium.WebElement> getHeadings()

Returns a list of table heading elements (<th>).

Multiple rows of heading elements, (<tr>), are flattened i.e. the second row, (<tr>), will follow the first, which can be misleading when the table uses colspan and rowspan.

Returns:

List with table heading elements.

getHeadingsAsString

public List<String> getHeadingsAsString()

Returns text values of table heading elements (contained in "th" tags).

Returns:

List with text values of table heading elements.

getRows

public List<List<org.openqa.selenium.WebElement>> getRows()

Returns table cell elements (<td>), grouped by rows.

Returns:

List where each item is a table row.

getRowsAsString

public List<List<String>> getRowsAsString()

Returns text values of table cell elements (<td>), grouped by rows.

Returns:

List where each item is text values of a table row.

getColumns

public List<List<org.openqa.selenium.WebElement>> getColumns()

Returns table cell elements (<td>), grouped by columns.

Returns:

List where each item is a table column.

getColumnByIndex

public List<org.openqa.selenium.WebElement> getColumnByIndex(int index)

Returns table cell elements (<td>), of a particular column.

Parameters:

index - the 1-based index of the desired column

Returns:

List where each item is a cell of a particular column.

getColumnsAsString

public List<List<String>> getColumnsAsString()

Returns text values of table cell elements (<td>), grouped by columns.

Returns:

List where each item is text values of a table column.

getCellAt

public org.openqa.selenium.WebElement getCellAt(int i,
                                                int j)

Returns table cell element (<td>), at i-th row and j-th column.

Parameters:

i - Row number

j - Column number

Returns:

Cell element at i-th row and j-th column.

getRowsMappedToHeadings

public List<Map<String,org.openqa.selenium.WebElement>> getRowsMappedToHeadings()

Returns list of maps where keys are table headings and values are table row elements (<td>).

getRowsMappedToHeadings

public List<Map<String,org.openqa.selenium.WebElement>> getRowsMappedToHeadings(List<String> headings)

Returns list of maps where keys are passed headings and values are table row elements (<td>),.

Parameters:

headings - List containing strings to be used as table headings.

getRowsAsStringMappedToHeadings

public List<Map<String,String>> getRowsAsStringMappedToHeadings()

Same as getRowsMappedToHeadings() but retrieves text from row elements (<td>).

getRowsAsStringMappedToHeadings

public List<Map<String,String>> getRowsAsStringMappedToHeadings(List<String> headings)

Same as getRowsMappedToHeadings(java.util.List) but retrieves text from row elements (<td>).