Terminate Existing Browser Options

Note:

Any change in this section of the Local Options dialog box will be effective after PTF client is restarted.

These options specify whether to check for active web driver processes when you exit the PTF client, and how to manage them. Multiple browsers are supported for test run via use of a web driver, which is a web automation framework that enables test run against different browsers. To assist in debugging, users have the option of leaving the test run browser session open after test execution, using a toggle available on the PTF Debug menu. However, the web driver used for each open session consumes machine memory, until that browser session is closed. Make sure the drivers and their associated browser sessions are properly managed, to prevent performance issues. There are also related options for managing the web drivers and test execution browser sessions in the PTF Debug menu and Tools menu.

Note:

In the PTF session if Runtime Options has Chrome specified as the browser then all open browser sessions including Chrome, Firefox, and Microsoft Edge opened from PTF will get closed.

If any other browser is specified then all the instances of the specific browser opened from PTF will be closed.

Term	Definition
On Exit	Determines if PTF should automatically check for leftover active driver sessions when terminating the client. Options are: Yes: Select this option to include a check for existing active driver processes when you terminate PTF. The value selected in the Prompt vs. Terminate field determines what action is taken. If Prompt is selected, you are prompted to close existing browser windows. If Terminate is selected all open browser windows will close without any prompt. No: PTF will not check for leftover sessions. You can check for active driver processes at any time by selecting Tools, Check/Stop Leftover Drivers from the PTF client menu.
Prompt vs. Terminate	The value selected in this field controls how PTF manages existing active web driver sessions. Options are: Prompt: Select this option to view a dialog box that includes a count and list of the active driver processes, and a prompt asking if you want to terminate them. Choose Yes to terminate all active driver processes, No to leave them active, or Cancel to return to the Test Editor window. Terminate: Select this option to automatically terminate all active driver processes. No prompt or preview of active driver processes appears when you select this option.

Term

Definition

On Exit

Determines if PTF should automatically check for leftover active driver sessions when terminating the client.

Options are:

Yes: Select this option to include a check for existing active driver processes when you terminate PTF. The value selected in the Prompt vs. Terminate field determines what action is taken.
- If Prompt is selected, you are prompted to close existing browser windows.
- If Terminate is selected all open browser windows will close without any prompt.
No: PTF will not check for leftover sessions.

You can check for active driver processes at any time by selecting Tools, Check/Stop Leftover Drivers from the PTF client menu.

Prompt vs. Terminate

The value selected in this field controls how PTF manages existing active web driver sessions. Options are:

Prompt: Select this option to view a dialog box that includes a count and list of the active driver processes, and a prompt asking if you want to terminate them. Choose Yes to terminate all active driver processes, No to leave them active, or Cancel to return to the Test Editor window.
Terminate: Select this option to automatically terminate all active driver processes. No prompt or preview of active driver processes appears when you select this option.

Note:

If the test includes steps to open new browser windows, set On Exit as Yes and Prompt vs. Terminate field as Terminate to avoid unexpected issues on the step Browser.WaitForNew.