com.rational.test.ft.object.interfaces

Class BrowserTestObject

java.lang.Object

com.rational.test.ft.object.interfaces.TestObject

com.rational.test.ft.object.interfaces.ClientTestObject

com.rational.test.ft.object.interfaces.GuiTestObject

com.rational.test.ft.object.interfaces.FrameTestObject

com.rational.test.ft.object.interfaces.TopLevelTestObject

com.rational.test.ft.object.interfaces.BrowserTestObject

All Implemented Interfaces:

IBrowserObject, IFrame, IGraphical, ITopWindow

public class BrowserTestObject
extends TopLevelTestObject
implements IBrowserObject

Provides script access to the general browser, which is the HTML Browser TestObject class.

Since:

RFT1.0

Field Summary

Fields inherited from class com.rational.test.ft.object.interfaces.TestObject

ignoreTheObjectState, ref

Fields inherited from interface com.rational.test.ft.object.interfaces.ITopWindow

INPUTCHARS_METHOD, INPUTKEYS_METHOD

Constructor Summary

Constructors

Constructor and Description
BrowserTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject) For internal use.
BrowserTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject, TestObject anchor) For internal use.
BrowserTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject, TestObject anchor, long scriptCommandFlags) For internal use.
BrowserTestObject(TestObject obj) Constructs one TestObject from another.
BrowserTestObject(com.rational.test.ft.object.TestObjectReference ref) For internal use.

Method Summary

Modifier and Type	Method and Description
boolean	back() Navigates the browser back to the previous page
void	deleteCookies() Deletes all of the browser's cookies.
void	deleteCookies(java.lang.String cookie, boolean recursive) Deletes browser cookies specified by the path in cookie
boolean	forward() Navigates the browser forward to the next page
boolean	home() Navigates the browser to the default home page.
void	inputChars(java.lang.String keys) Sends the supplied characters to the associated window.
void	inputKeys(java.lang.String keys) Sends the supplied characters to the associated window.
boolean	loadUrl(java.lang.String url) Loads the given URL into the browser.
boolean	loadUrl(java.lang.String url, java.lang.String target) Loads the given URL into the browser.

Methods inherited from class com.rational.test.ft.object.interfaces.TopLevelTestObject

activate, clickDisabled, close, isIconified, maximize, minimize, move, resize, restore

Methods inherited from class com.rational.test.ft.object.interfaces.FrameTestObject

contextHelp

Methods inherited from class com.rational.test.ft.object.interfaces.GuiTestObject

canTakeVP, click, click, click, click, clickRadio, doubleClick, doubleClick, doubleClick, doubleClick, drag, drag, drag, drag, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, ensureObjectIsVisible, getChildAtPoint, getClippedScreenRectangle, getImage, getImage, getIWindow, getRole, getScreenPoint, getScreenPoint, getScreenRectangle, getScreenSnapshot, getVisibleArea, hasFocus, hover, hover, hover, hover, invokeProxyWithGuiDelay, invokeProxyWithGuiDelay, isEnabled, isOpaque, isPointInObject, isShowing, mouseMove, mouseMove, nClick, nClickDrag, nClickDragToScreenPoint, switchTo

Methods inherited from class com.rational.test.ft.object.interfaces.ClientTestObject

exists, exists, exists, find, find, findAndInvoke, findAndInvokeProxy, getProperty, getTestDataTypes, invoke, invokeProxy, unregister, waitForExistence

Methods inherited from class com.rational.test.ft.object.interfaces.TestObject

compare, compare, compareAndLog, compareAndLog, equals, find, findAndInvoke, getActualData, getChildren, getDescribedObject, getDescribedObjects, getDescriptiveName, getDomain, getField, getIndexer, getIndexer, getIndexers, getMappableChildren, getMappableParent, getMapProperties, getMethods, getNameInScript, getNonValueProperties, getObjectClassName, getObjectCustomClassName, getObjectReference, getOwnedObjects, getOwner, getParent, getProcess, getProperties, getPropertyFromMap, getRecognitionProperties, getRecognitionPropertyWeight, getScriptCommandFlags, getStandardProperties, getTestData, getTopMappableParent, getTopParent, hashCode, invoke, invoke, invoke, invokeProxy, invokeProxy, isHtmlWebui, isLoggedDuringUnregister, isMappedObject, isSameObject, isScreenTestObject, isTopLevelTestObject, performTest, performTest, performTest, performTest, setIndexer, setIndexer, setLoggedDuringUnregister, setMapProperties, setProperty, toString, updateTestData, waitForExistence

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.rational.test.ft.object.interfaces.IFrame

contextHelp

Methods inherited from interface com.rational.test.ft.object.interfaces.IGraphical

click, click, click, click, doubleClick, doubleClick, doubleClick, doubleClick, drag, drag, drag, drag, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, getChildAtPoint, getClippedScreenRectangle, getScreenPoint, getScreenPoint, getScreenRectangle, hasFocus, hover, hover, hover, hover, isEnabled, isOpaque, isPointInObject, isShowing, mouseMove, mouseMove, nClick, nClickDrag, nClickDragToScreenPoint

Constructor Detail

BrowserTestObject

public BrowserTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject)

For internal use.

Since:

RFT1.0

BrowserTestObject

public BrowserTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject,
                         TestObject anchor)

For internal use.

Since:

RFT1.0

BrowserTestObject

public BrowserTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject,
                         TestObject anchor,
                         long scriptCommandFlags)

For internal use.

Since:

RFT1.0

BrowserTestObject

public BrowserTestObject(com.rational.test.ft.object.TestObjectReference ref)

For internal use.

Since:

RFT1.0

BrowserTestObject

public BrowserTestObject(TestObject obj)

Constructs one TestObject from another. Both are references to the same object.

Since:

RFT1.0

Method Detail

back

public boolean back()

Description copied from interface: IBrowserObject

Navigates the browser back to the previous page

Specified by:

back in interface IBrowserObject

Returns:

boolean - true when the navigation starts; false when there is no previous page.

forward

public boolean forward()

Description copied from interface: IBrowserObject

Navigates the browser forward to the next page

Specified by:

forward in interface IBrowserObject

Returns:

boolean - true when the navigation starts; false when there is no forward page.

home

public boolean home()

Description copied from interface: IBrowserObject

Navigates the browser to the default home page.

Specified by:

home in interface IBrowserObject

Returns:

boolean - true when the navigation starts; false when there is no home page defined for this browser.

loadUrl

public boolean loadUrl(java.lang.String url,
                       java.lang.String target)

Description copied from interface: IBrowserObject

Loads the given URL into the browser.

Specified by:

loadUrl in interface IBrowserObject

Parameters:

url - string path of the page to load into browser

target - string name of the HTML frame where page is to be loaded

Returns:

boolean - true when the page load starts; false if the page does not load.

loadUrl

public boolean loadUrl(java.lang.String url)

Description copied from interface: IBrowserObject

Loads the given URL into the browser.

Specified by:

loadUrl in interface IBrowserObject

Parameters:

url - string path of the page to load into browser

Returns:

boolean - true when the page load starts; false if the page does not load.

deleteCookies

public void deleteCookies()

Description copied from interface: IBrowserObject

Deletes all of the browser's cookies.

Specified by:

deleteCookies in interface IBrowserObject

deleteCookies

public void deleteCookies(java.lang.String cookie,
                          boolean recursive)

Description copied from interface: IBrowserObject

Deletes browser cookies specified by the path in cookie

Specified by:

deleteCookies in interface IBrowserObject

Parameters:

cookie - The full path of the cookie. This is usually the domain followed by the directory path in which the intended document resides, for example, http://a.com.

recursive - If set, all cookies that are children of the path specified in cookie are deleted, for example, a.com/b/.

inputChars

public void inputChars(java.lang.String keys)

Description copied from class: TopLevelTestObject

Sends the supplied characters to the associated window. The window is responsible for sending the characters on to the appropriate controls nested in that window. The characters are uninterpreted. For example, inputChars("+a+b") emits "+a+b", in contrast to inputKeys("+a+b"), which interprets the "+" as a shift and emits "AB".

Specified by:

inputChars in interface ITopWindow

Overrides:

inputChars in class TopLevelTestObject

Parameters:

keys - The characters to be processed by this window

inputKeys

public void inputKeys(java.lang.String keys)

Description copied from class: TopLevelTestObject

Sends the supplied characters to the associated window. The window is responsible for sending the characters on to the appropriate controls nested in that window. The characters in the given string are interpreted according to the rules documented under ITopWindow.inputKeys.

Specified by:

inputKeys in interface ITopWindow

Overrides:

inputKeys in class TopLevelTestObject

Parameters:

keys - the characters to be processed by this window