Browser

Description
A class for a web browser that offers basic navigation and interactions with the web browser that are not part of the webpage itself, such as FileDownload.
Implements the IBrowser interface.
Browser Class
Namespace:  Progile.TRIO.EnvironmentModel.WebBrowser
Assembly:  Progile.TRIO.EnvironmentModel.Windows (in Progile.TRIO.EnvironmentModel.Windows.dll)
Inheritance Hierarchy:
​Object
  Progile.TRIO.BaseModel.OnScreenElement
    Progile.TRIO.BaseModel.BaseScreen
      Progile.TRIO.EnvironmentModel.Window
        Progile.TRIO.EnvironmentModel.WebBrowser.Browser

Constructors
Syntax:
public Browser(
	ITester t,
	ISystemHelpers systemHelpers
)
Parameter
Description
t
Type: ITester​
The tester interface.
systemHelper
Type: ISystemHelpers​
An instance of the ISystemHelpers interface that allows interaction with the SUT operating system.
Methods
Name
Description
​Authenticate​
Authenticates to the server authentication request which is handled by windows or the browser, and not the webpage itself.
If no AuthenticationDialog was found on the screen, the method assumes no authentication was required and does nothing.
​CheckDownloadSuccessful​
Checks the download was successful and cleans up the notifications and dialogs from the download.
​DownloadAndSaveFileAs​
Downloads and saves a file under the given path. Browser needs to be configured that it asks what to do with the file to download. This method assumes there is already a download request initiated.
​GetURL​
Copies the URL from the URL textbox and returns it as a string. Special handling for edge to trim \r at the end and close the suggestions.
​GoBack​
Goes back one page using the browser back button. Caller needs to wait for and verify the expected page.
​GoForward​
Goes forward one page using the browser forward button. Caller needs to wait for and verify the expected page.
​GoToURL​
Navigates the browser to an URL. URL should end in "/" to avoid problems with verification.
Properties
Name
Description
​BackButton​
The icon to navigate one page back.
​BrowserWindow​
The Select defining the content of the browser window. Does not contain Browser toolbars, tabs and URL textbox.
​DownloadDialog​
The download dialog that is opened when a download is requested on a webpage (except on Chrome where directly a FileDialog is opened).
​FwdButton​
The icon to navigate one page forward.
​HomeButton​
The icon to navigate to the home page. This icon is also used to check if a browser is open and depending on which representation is found, defines the Browser.Type.
​RefreshButton​
The icon to refresh the current page.
​Type​
The type of the browser (e.g. IE, Firefox, Edge or Chrome).
​URLTextBox​
The url textbox.

WebBrowser

Browser Methods

Last modified 3yr ago

Parameter	Description
t	Type: ITester The tester interface.
systemHelper	Type: ISystemHelpers An instance of the ISystemHelpers interface that allows interaction with the SUT operating system.

Name	Description
Authenticate	Authenticates to the server authentication request which is handled by windows or the browser, and not the webpage itself. If no AuthenticationDialog was found on the screen, the method assumes no authentication was required and does nothing.
CheckDownloadSuccessful	Checks the download was successful and cleans up the notifications and dialogs from the download.
DownloadAndSaveFileAs	Downloads and saves a file under the given path. Browser needs to be configured that it asks what to do with the file to download. This method assumes there is already a download request initiated.
GetURL	Copies the URL from the URL textbox and returns it as a string. Special handling for edge to trim \r at the end and close the suggestions.
GoBack	Goes back one page using the browser back button. Caller needs to wait for and verify the expected page.
GoForward	Goes forward one page using the browser forward button. Caller needs to wait for and verify the expected page.
GoToURL	Navigates the browser to an URL. URL should end in "/" to avoid problems with verification.

Name	Description
BackButton	The icon to navigate one page back.
BrowserWindow	The Select defining the content of the browser window. Does not contain Browser toolbars, tabs and URL textbox.
DownloadDialog	The download dialog that is opened when a download is requested on a webpage (except on Chrome where directly a FileDialog is opened).
FwdButton	The icon to navigate one page forward.
HomeButton	The icon to navigate to the home page. This icon is also used to check if a browser is open and depending on which representation is found, defines the Browser.Type.
RefreshButton	The icon to refresh the current page.
Type	The type of the browser (e.g. IE, Firefox, Edge or Chrome).
URLTextBox	The url textbox.