Standard properties available for functional testing HTML objects
Standard properties provide a common way to access properties and their values across browsers. This topic lists the standard properties available for HTML objects.
Most of these properties are modeled on HTML element attributes defined by the W3C.
Property Use .align Value of the align attribute of the element. Valid values are bottom, middle, and top. .alt Value of the alt attribute of an element. This is the "alternate" text for the element, usually displayed by the browser when the mouse hovers over the element. .border Value of the border attribute of the element. Returns the number of pixels. .bounds Rectangle that represents the bounding rectangle of the object in screen coordinates. .caption For TABLE elements, the value of the caption attribute. For an HTML dialog box, this is the name of the dialog box. .cellIndex Cell index of an element with respect to its row (>=0). .checked Boolean value that indicates whether a check box is checked (true) or not (false). .class TestObject class name; for example, "HtmlTable" for a TABLE element. .className Value of the class attribute of an element (used for stylesheets in HTML). .clientRect Bounding rectangle of the element in client coordinates. .code Value of the code attribute of an APPLET element. .codeBase Value of the codeBase attribute of an APPLET element. .colSpan Value of the colSpan attribute of an element. .cookie Current value of the cookie for the document. .coords Value of the coords attribute of an element. This is a string containing the coordinates used to define the AREA element of a client-side image map. In the form x1, y1, x2, y2, and so on. .defaultChecked Boolean value for the defaultChecked attribute of the element. .defaultSelected Boolean value; when true indicates that the OPTION element in a SELECT element (listbox or dropdown) is selected by default when the page is displayed. .defaultValue Value of the defaultValue attribute of the element. .disabled Value of the disabled attribute of an element, returned as a boolean. If true, user input is currently disabled for this item. .hasFocus Indicates whether the current element has focus. .hasScript Boolean value; true when a script has been associated with actions on this element. .height Value of the height attribute of an element. For an Image element, this is the display height in pixels for the image. .href Value of the href attribute of an element. This is a URL used by ANCHOR and AREA elements to indicate the result of clicking the corresponding element. .hspace Value of the hspace attribute of an element, the amount of whitespace inserted to the left or right of an IMG, OBJECT, or APPLET element. .id Value of the id attribute of an element. .indeterminate Boolean value; true when the status of the check box has been changed. .index Index of the OPTION element within a listbox or combodropdown list. .isMap Boolean value; for Image elements (IMG), this value is true when the element is a server-side image map. .length Value of the length attribute of an element. For a SELECT element, this indicates the number of items in the list. .maxLength For an edit control (Input type=Text or TextArea) this indicates the maximum number of characters a user can enter. .multiple Boolean value; for a SELECT element (listbox or combo dropdown), a value of true indicates that the list supports multiple selections. .name Value of the name attribute (Form elements and Frames only). .noHref Value of the noHref attribute of an element. When set on an AREA element, indicates that the corresponding area has no associated action. .offsetHeight Height of the element. .offsetLeft Offset, in pixels, of the element from its left edge to the left edge of its parent element in the DOM. .offsetRight Offset, in pixels, of the element from its right edge to the right edge of its parent element in the DOM. .offsetTop Offset of the element from the offset of its parent element in the DOM. .offsetWidth Width of the element. .readOnly Value of the readOnly attribute of an element. Boolean value; true when the form element is read-only. .readyState
Current status of a browser, indicating whether it is currently loading a document or ready for user input. This is an integer value:
0 - Uninitialized
1 - Loading
2 - Loaded
4 - Complete (ready)
.rowIndex Row index of an element in a table (>=0 ). .rows Value of the rows attribute of a TEXTAREA element, indicating the size of the edit control in the number of rows of text. .rowSpan Value of the rowSpan attribute of an element. .screenLeft Upper left corner of bounding rectangle in screen coordinates, x component. .screenTop Upper left corner of bounding rectangle in screen coordinates, y component. .select Boolean value; true when the FORM element is highlighted to receive user input. .selected Boolean value; true when the OPTION element in a SELECT element (listbox or dropdown) is selected. .selectedIndex Value of the selectedIndex attribute of an element. For a single selection Select element, this indicates which option element is selected. Integer in the range of >=0. .shape Value of the shape attribute of an element. Used for AREA elements in client-side image maps. Valid values are default, rect, circle, and poly. .size Value of the size attribute of an element. For a Select element, the number of items displayed at one time in the list. If size > 1, the list appears as listbox; otherwise the list appears as a Combodropdown. .src Value of the src attribute for the element. For images and image buttons, this is a URL specifying the image file. .tag HTML tag for the element. .target Value of the target attribute of an element. For anchors, this indicates the name of the target frame, that is, the frame where the document should be opened. .text
Text inside of the HTML tags for bounding the element. For example:
<A>This is an Anchor<IMG src=map.gif></a>
The text property returns "This is an Anchor." If consecutive white space characters are found, all white spaces are combined and reduced to a single blank character.
.title Value of the title attribute of an element. This is frequently the text displayed when hovering over the element with the mouse. .type Value of the type attribute of an element. For example, for an Input element this is text, password, check box, radio, submit, image, reset, button, hidden, or file. .url URL of the document. .useMap Value of the useMap attribute of an element. The value is a string specifying a URL and is used for IMAGE elements (IMG) to indicate a client-side image map. The URL points to the map associated MAP element. Frequently, this is a document-relative reference. .value Value of the value attribute of an element. In Form elements this represents the value sent when the form is posted. .vspace Value of the vspace attribute of an element, the amount of whitespace inserted to the above or below an IMG, OBJECT, or APPLET element. .width Value of the width attribute of an element. For an IMAGE element, this is the display width in pixels for the image. .window Heavyweight window for the element returned as a long. For the Browser, this is the top-level window.