com.rational.test.ft.object.interfaces
Interface IBrowserObject

All Known Implementing Classes:

BrowserTestObject, EmbeddedBrowserTestObject

public interface IBrowserObject

Supported by objects that represent HTML browser objects.

Since:

RFT1.0

Method Summary

boolean	back() Navigates the browser back to the previous page.
void	deleteCookies() Deletes all of the browser's cookies for the current profile/user.
void	deleteCookies(java.lang.String cookie, boolean recursive) Deletes browser cookies specified by the path in cookie for the current profile/user.
boolean	forward() Navigates the browser forward to the next page.
boolean	home() Navigates the browser to the default home page.
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.

Method Detail

back

public boolean back()

Navigates the browser back to the previous page. This is the same as clicking the back button in the browser.

Returns:

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

Since:

RFT1.0

forward

public boolean forward()

Navigates the browser forward to the next page. This is the same as clicking the forward button in the browser.

Returns:

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

Since:

RFT1.0

home

public boolean home()

Navigates the browser to the default home page. Note that this depends on the configuration of the given browser.

Returns:

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

Since:

RFT1.0

loadUrl

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

Loads the given URL into the browser. The page is loaded into the frame identified by the target.

Parameters:

url - URL-identified page to load into browser

target - name of frame where the page is loaded

Returns:

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

Since:

RFT1.0

loadUrl

public boolean loadUrl(java.lang.String url)

Loads the given URL into the browser.

Parameters:

url - URL-identified page to load into browser

Returns:

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

Since:

RFT1.0

deleteCookies

public void deleteCookies()

Deletes all of the browser's cookies for the current profile/user.

Throws:

UnableToDeleteCookieException - if the cookie can not be deleted

Since:

RFT1.1

deleteCookies

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

Deletes browser cookies specified by the path in cookie for the current profile/user. There is an option to perform a recursive delete.

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/.

Throws:

CookieNotFoundException - when the specified cookie can not be found

UnableToDeleteCookieException - if the cookie can not be deleted

Since:

RFT1.1