IBM Rational Functional Tester
Version 6.1
IBM Rational Functional Tester API Reference

Project Version 2.0

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