Open source web testing tool
The future of automated web testing is open source

API Guide - Table
Courses in c#, ruby, shell scripting, Software testing courses and more

See a video tour 		Thwameva technologies offers a state of the art advanced training using multimedia video mentoring , practical oriented training and experts as mentors(*). Thwameva offers software testing courses, courses in WET, ruby, C#, shell scripting and more...
The unique combination of video mentoring by experts and mentor assisted training programs are applicable only for software training courses in Thwameva's Bangalore office.

Thwameva technologies is the primary sponsor for the WET project
 
Main       Web Objects       Win Objects       Test Mgmt       Others      
Class WET::WebTable
In: WebTable.rb
Parent: WebContainer

Class that represents a Web Table.This class is a child of Watir’s table.It also provided some additional methods to better manage a table.A table is a container.You can use the various creators provided by other containers like Browser or Frame.For example you could say,#..Table(..).Image(…)#.

Check the WebContainer document for details about the container methods.

HTML Tables on a web page can be controlled in WET using the Table object.WET Tables are full blown containers whose child objects can be retreived.

Methods

Row   check_exists   check_not_exists   check_text   check_text_absent   column_count   new   row   row_count   text   to_s   typingspeed  

Methods Inherited from WebContainer

Button   Checkbox   File   IFrame   Image   Link   List   Radio   Table   TextField   Textarea   button   checkbox   div   element_by_tagname   file_field   iframe   image   link   p   radio   select_list   span   table   text_field   textarea  

Methods Inherited from WebObject

browser   exists?   fire_event   id   index   is_exist   name   tag_name  

Attributes

container  [R] 

Public Class methods

new(container, params) 
    This is to initialize a Table.
    The syntax to get the reference of a Table is :
    Container.Table("name:=value")
    Where
    Container    is a Browser, Frame, Table or any other container that can hold HTML elements as its children.
    name         is the name of the attribute to be checked.
    value        is the value of that attribute.

Example

     Browser('title:=Controls').Table('id:=tbl001')

     The commonly used attributes to identify an Image are:
     id       The HTML id attribute of the table
     text       The text of this table. The text of the table is the aggregate of the cell's text.

Public Instance methods

Row(*params)

Get the Row from the table whose properties match the specified arguments.It can be very handy to be able to get a row.For example,you could have a table of employees in which employee ID is the first column,the other columns have other data pertaining to the employee.To check various details about an employee,you could retreive the row whose text starts with the employee ID and confirm that all other details in that row match the required employees details. 

  The typical parameters use to retreive a row are:

     text - Text displayed in the table
     index
check_exists()

Check to see if the table actually exists on the page.If the table actually does exist,then prints out a success message in the test report.If it doesn’t exist,then it prints out a failure in the report. One example of using this check is immediately after performing ‘add’ operations.For example,after adding a new user,you may want to check that the user link actually does exist.

check_not_exists()

Check to see if the table *does not* exist on the page.If the table does not exist,then prints out a success message in the test report.If it actually does exit,then it prints out a failure in the report. One example of using this check is immediately after performing ‘delete’ operations.For example,after deleting ‘abc’,you may want to check that the user link for ‘abc’ has been deleted.

check_text(search_text)

Verifies that the text displayed in the Table matches the text which is searched .If the table’s text matches the search_text,then a success message is printed in the test report.Otherwise,a failure is printed out in the report. The search_text parameter can either be a string literal (to do an exact match)or a regular expression.

check_text_absent(search_text)

This command is used to check that a particular text is not displayed in the table. This is usually used in negative test cases.This checks if the expected text does not match the text of the table. If the check is successful,that is,the table’s text does not match the expected text,then a success is printed in the test report.If the check fails,then a failure is printed in the test report.

column_count(row_index=1)

Get the number of columns in the table. The number of columns also represents the number of fields .

row(*params)

Alias for Row

row_count()

Get the number of rows in the table. The number of rows also represents the different categories of data

text()

Get the text() of the table. The text of the table is aggregate of text displayed in all the table’s cells.

typingspeed()

Should not be required later

Methods Inherited from the WebContainer class

Button(*props)

Find a Button with the specified properties, The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The common properties used to identify a button are :

  • name - The html name attribute of the button
  • id - The html id attribute of the button
  • value - The value of the button is the text displayed on the button.
Checkbox(*props)

Find a Web checkbox with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The properties used to identify a checkfield are:

  • name - The html name attribute of the checkbox
  • id - The html id attribute of the checkbox
  • label - The checkbox’s label. The checkbox’s label is the text that is 
     displayed to the left of the checkbox.
File(*props)

Find a Web File with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The properties used to identify a File are:

  • name - The html name attribute of the file element
  • id - The html name attribute of the file element
  • label - The File element’s label. The label of a file element is the 
     text displayed to the left of the file.
IFrame(*props)

Find an IFrame with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The properties used to identify a Textarea are:

  • name - The html name attribute of the text area
  • id - The html id attribute of the text area.
  • text - The text contained in the IFrame
Image(*props)

Find an Image with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The common properties for an image are

  • id - The html id attribute of the image
  • src - The source path
Link(*props)

Get a web Link with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

For a link the following are the commonly used properties:

  • id - The html id attribute of the link
  • text - Text that is displayed for the link.
  • href - Url to which this link points to
List(*props)

Find a Web List with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The properties used to identify a List are:

  • name - The html name attribute of the web list
  • id - The html id attribute of the web list.
  • label - The Lists’s label. A lists label is the text that is 
     displayed to the left of the weblist
Radio(*props)

Find a Web radio button with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The properties used to identify a radio button are:

  • name - The html name attribute of the radio button
  • id - The html id attribute of the radio button
  • label - The radio button’s label. In the case of a radio button, the 
     label is considered to be the textimmediately after the radio.
Table(*props)

Find a HTML Table with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The properties with which a table can be identified are:

  • id - The html id of the table
  • text - This is a very useful way to identify a table. Sometimes the only 
     info that is available about a table is the text contained in the table.
 The table's text is the aggregate of the contents of the cells of the table.
TextField(*props)

Find a Web textfield with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The properties used to identify a textfield are:

  • name - The html name attribute of the Textfield
  • id - The html id attribute of the Textfield
  • label - The textfield’s label. The textfield’s label is the text 
     displayed to the left of the textfield.
Textarea(*props)

Find a Textarea with the specified properties. The properties are specified as name-value pairs using the syntax: 

    "property_name:=value"

The value can either be a string literal or a string representing a regular expression. To emulate a regular expressioin, the value starts and ends with the ’/’ character. For example, "name:=/some.*/"

The properties used to identify a Textarea are:

  • name - The html name attribute of the text area
  • id - The html id attribute of the text area.
button(*props)

Alias for Button

checkbox(*props)

Alias for Checkbox

div(props)

Convenience method to access div elements

element_by_tagname(tag_name, props)

Get an element based on the tagname. This is useful for those cases where there is no predefined WET class for a particular tag but a scripter needs to use it.

  • tag_name = Name of the tag, eg. p, div, etc.,
  • props = Hashtable of name-value properties for searching.

For example if you want to get a <div> element whose id is ‘myId’, then you can say 

    element_by_tag_name("div", "id" => "myId")
file_field(*props)

Alias for File

iframe(*props)

Alias for IFrame

image(*props)

Alias for Image

link(*props)

Alias for Link

p(props)

Convenience method to access <p> elements

radio(*props)

Alias for Radio

select_list(*props)

Alias for List

span(props)

Convenience method to access span elements

table(*props)

Alias for Table

text_field(*props)

Alias for TextField

textarea(*props)

Alias for Textarea

Methods inherited from Web Objects

browser()

Get the WebBrowser object which hosts this element

exists?()

Check to see if the object exists or not at runtime.

Returns true if the object exists, false if it doesn’t

fire_event(evt)

Emulate firing an event - For example - moving mouse over, etc,.

id()

Get the ‘id’ attribute that is associated with this element

index()

Get the index of this element w.r.t its container.

is_exist()

Alias for exists?

name()

Get the ‘name’ attribute that is associated with this element

tag_name()

Get the html tag of this element. For example: <input> for textfield, <img> for image, etc.,

 
WET is a opensource automated web testing tool which uses Watir as the library to drive web pages. WET drives an IE Browser directly and so the automated testing done using WET is equivalent to how a user would drive the web pages. WET extends the scripting abilities of Watir and also offers the convenience of recorders. It is licensed under LGPL and BSD style open source licenses.

WWW wet.qantom.org
Search powered by Google