Closing Browsers

Closing a Browser From Keyword Tests

Closing a Browser From Scripts

When recording a test, close the web browser after all the desired operations are performed. Closing the browser is recorded as the Close method of the BrowserWindow object that corresponds to the current browser window.

The Close method has the WaitTimeout parameter that pauses the script execution for the specified time or until the window closes. If any of your browsers closes slowly, in order to avoid starting a new test before the browser closes, increase the parameter’s value.

The image below is a sample keyword test that performs some actions over the tested web page and then closes the active browser.

Sample keyword test that closes the browser after all the operations are performed

Another way to close the browser is to call the Close method of the corresponding Browser process. This method closes the browser process directly. For browsers with a multi-process architecture (like Google Chrome or Internet Explorer 10 and later), the Browser.Close() method closes the main browser process along with the child browser processes. The method’s WaitTimeout parameter pauses the test execution for the specified time or until the main and auxiliary  browser processes are closed.

If you recorded a test without closing the browser, you can add the closing operation manually. To do this, use the Call Object Method operation. For more information on how to call object methods from keyword tests, see Calling Object Methods.

To close a web browser from scripts, you can use the BrowserWindow.Close() or Browser.Close() scripting method:

• The BrowserWindow.Close() method closes the corresponding browser window. Typically, a browser has only one window (additional browser windows can be opened using the browser’s New Window or Open Link In New Window command.) If there is a single browser window, closing the window will result in closing the browser.

• The Browser.Close() method closes the browser process directly. At that, it also closes all browser windows and all auxiliary browser processes.

Both methods have the WaitTimeout parameter that specifies the amount of time to wait before closing the browser window or process, respectively. For the Browser.Window.Close() method, the default WaitTimeout parameter value is 2000, for Browser.Close() – 60000, but you can specify any other value.

The following sample script demonstrates how you can close the web browser after all the desired actions are performed.

def Test1():
  # Run the web browser and obtain a web page
  Browsers.Item[btIExplorer].Run("http://smartbear.com/");
  browser = Sys.Browser();
  page = browser.Page("*smartbear.com*")

  # ...
  # Test the page
  # ...

  # Close the web browser
  browser.Close();