Class represents a browser instance managed by the Manager.
This object exposes all the browser specific information and methods to automate
the underlying browser that this instance represents.
Inheritance Hierarchy
ArtOfTest.WebAii.CoreBrowser
Namespace: ArtOfTest.WebAii.Core
Assembly: ArtOfTest.WebAii (in ArtOfTest.WebAii.dll) Version: 2018.1.116.0 (2018.1.116.0)
Syntax
The Browser type exposes the following members.
Properties
Name | Description | |
---|---|---|
Actions |
Gets the Actions object that can be used to perform different actions against the loaded document in the browser.
| |
Annotator |
Gets the Annotator object associated with this browser.
| |
AutoDomRefresh |
Gets/Sets whether to automatically refresh the DOM tree after each browser command.
| |
AutoWaitUntilReady |
Gets/Sets whether to automatically wait until browser is ready after each browser command.
| |
BrowserType |
Gets the browser type (i.e. IE/FireFox ...etc)
| |
ClientId |
The unique ID for this browser that the manager identifies it with.
| |
CommandTimeOut |
Gets/Sets the max wait time in milliseconds that the
browser will wait for a command to process
before it times out.
| |
ContentRectangle |
Gets the rectangle of the content window or element
| |
ContentWindow |
Gets the container window of the browser that contains the actual content of the page.
(Excludes the browser toolbars, buttons ...etc.)
| |
Cookies |
Gets the cookies manager associated with this browser that allows you
to retrieve, delete and add cookies.
| |
CreationTime |
The UTC time this instance was instantiated.
| |
Desktop |
Desktop object that draws its annotations in this browser
| |
DomTree |
Gets the DOM Tree representation of the currently loaded document.
| |
Find |
Gets the Find objects used to provide a rich set of methods to help identify elements in
the Dom tree associated with this browser object.
| |
FrameElement |
Gets the Element object for the frame element represented by this Browser object, if this Browser represents
a frame. If this Browser does not represent a frame, FrameElement is null.
| |
FrameInfo |
Gets the frame information if IsFrame = true else will return null.
FrameInfo contains frame index and frame name.
| |
Frames |
List of child frames contained in this instance
| |
FriendlyName |
Get a friendly name for this browser instance.
| |
IsConnected |
Gets whether the browser is connected to manager of not.
| |
IsFrame |
Gets whether this instance represents a frame or not.
| |
IsIEDialog |
Gets whether this instance is an IE dialog (Modal/Modeless)
| |
IsUILess |
Whether this browser is UI less browser. (i.e. a raw http request/response browser)
| |
Manager |
The manager of this browser object.
| |
NativeInstance |
The native instance of this browser object (if available), otherwise null
| |
PageTitle |
Gets the page title if one exists. (text content of the 'title' tags)
| |
QueryString |
Gets a parsed name/value collection of the query string.
| |
Regions |
Gets a dictionary of all identified test regions in the currently loaded document.
| |
StateHashCode |
Get the state hash code.
| |
TechnologyType |
Get the technology type
| |
UniqueId |
Gets a unique id that identifies this browser instance.
| |
Url |
Gets the current page URL. This property is refreshed when calling RefreshDOMTree().
| |
Version |
The browser version for this browser type.
| |
ViewSourceString |
Gets the source of the page currently loaded in the browser.
This is the string that the framework used to build the DOM.
| |
Window |
Gets the Win32 window object representing the actual browser window.
|
Methods
Name | Description | |
---|---|---|
Capture |
Capture the image of this browser
| |
ClearCache |
Clear the cache of a certain category.
| |
Close |
Closes a browser window.
| |
Close(Int32) |
Closes a browser window with a custom wait to close timeout.
| |
ContainsPoint |
True/False whether a specific point falls within this browser/frame rendering region
| |
ContainsRectangle |
True/False whether a specific rectangle falls within this browser/frame rendering region
| |
ContainsText |
True/False whether the 'text' is contained within the page currently loaded. Not case sensitive.
| |
Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) | |
ExecuteCommand(BrowserCommand) |
Executes a command against this browser instance.
| |
ExecuteCommand(BrowserCommand, Boolean, Boolean) |
Executes a command against this browser instance.
| |
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) | |
GetChildHosts |
Get all containing child hosts. For Browser, this will return a list of all Frames (if any) + any SilverlightApp instances
| |
GetHashCode | Serves as the default hash function. (Inherited from Object.) | |
GetHostRoot |
Get the root element of the DomTree
| |
GetSelectedText |
Gets the text currently selected by the user in the browser window
| |
GetType | Gets the Type of the current instance. (Inherited from Object.) | |
GoBack |
Simulates a go back browser action.
| |
GoForward |
Simulates a go forward browser action.
| |
IsReady |
Gets whether the browser is ready or not.
| |
LocateAllInHost |
Locates all elements contained in the browser's DOM matching the specified find expression.
| |
LocateInHost |
Locate an element in the host using an expression.
| |
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) | |
NavigateTo(String, Boolean) |
Navigate the browser to a specific url and then enable the script logging.
| |
NavigateTo(Uri, Boolean) |
Navigate the browser to a specific url.
| |
PrepareFrameForClosing |
Used to disable the AutoRefreshDom and WaitUntilReady of a frame preparing it to be
closed on next action and no longer pulled by the framework.
| |
Refresh |
Simulates a browser Refresh.
| |
RefreshDomTree |
Force a referesh of the DOM tree from the current document.
| |
ResizeContent(Rectangle) |
Resize the browser window content to the specified window rectangle.
This function will handle the padding between the outer browser window and the content window.
If the new rectangle will not fit within the bounds of the screen, this method will try to
approximate the requested size within the bounds of the screen.
| |
ResizeContent(Int32, Int32, Int32, Int32) |
Resize the browser window content to the specified window rectangle.
This function will handle the padding between the outer browser window and the content window.
| |
ScrollBy |
Scroll this window by offset x horizontally and y vertically.
| |
Stop |
Simulate a stop navigation browser action.
| |
ToggleFullScreen |
Toggle the browser in and out of Full Screen (F11)
| |
ToString | Returns a string that represents the current object. (Inherited from Object.) | |
TranslateBrowserOffset |
Translates an offset from one browser to another. Useful because offset values recorded in Internet Explorer
are typically two pixels different from offset values for the same relative point in other browsers.
| |
UpdateDomTree |
Parse and update the DomTree
| |
UpdateInterHostLinks |
Ensures that any links between hosts are up-to-date (Infrastructure use only)
| |
WaitForAjax |
Wait for any active AJAX requests to complete.
| |
WaitForElement(Int32, String) |
Wait for an element to exist. If it exists, return the Element object, else will throw a Timeout Exception.
| |
WaitForElement(HtmlFindExpression, Int32, Boolean) |
Wait for an element to exist. If it exists, return the Element object, else will throw a Timeout Exception.
| |
WaitForFrame(FrameInfo) |
Wait for a frame to exist. Uses the Settings.ClientReadyTimeout as the timeout
| |
WaitForFrame(FrameInfo, Int32) |
Wait for a frame to exist.
| |
WaitForUrl |
Wait for a specific url to be set. This can be used to wait for browser redirects
on certain sites.
| |
WaitUntilReady |
Waits for the browser until its ready
|
Events
Name | Description | |
---|---|---|
AfterCommandExecuted |
Event occurs after the command is executed and the response is available.
| |
BeforeCommandExecuted |
Event occurs before a command is pushed to the browser.
| |
Closing |
Event occurs when the browser is about to close. [Browser.Close()] is called.
| |
DomRefreshed |
Event occurs after the DomTree is rebuilt (either after a command is executed or when RefreshDom is called)
|
Extension Methods
Name | Description | |
---|---|---|
GetSilverlightAppIndex |
Finds the index into the SilverlightApp array of the specified plugin
(Defined by SilverlightAppFinder.) | |
SilverlightApps |
Returns an array of all Silverlight Applications on this page.
(Defined by SilverlightAppFinder.) | |
TagFrame | (Defined by BrowserExtensions.) |
See Also