[Windows] Start Application with Title

Description

Start Windows driver and starts the Windows application at the given absolute path. After the application starts, if WinAppDriver cannot detect the main application window correctly, Katalon Studio will use the given window title parameter to find the opened application to continue working.

Keyword name: startApplicationWithTitle

Parameters

Parameter	Parameter Type	Required	Description
appFile	String	Yes	Absolute path to the Windows application.
windowTitle	String	Yes	Title of the opening application windows. Full text, partial text, or regular expression input is acceptable.
matchingStrategy	StringMatchingStrategy (enum)	Optional	Specifies the strategy to match the windowTitle parameter against the actual window title. Allowed values are: CONTAINS: (default value) The windowTitle parameter should be a substring of the actual window title. REGEXP: The windowTitle parameter should be a valid regular expression pattern that matches the actual window title. EXACT: The windowTitle parameter should exactly match the actual window title.
flowControl	FailureHandling	Optional	Specify failure handling schema to determine whether the execution should be allowed to continue or stop.

Returns

Parameter Type	Description
StepFailedException	Throws an error if Katalon Studio could not start Windows Driver, could not start the application, the application file doesn't exist or there is no application matches the object.

Example

Windows.startApplicationWithTitle('C:\\Program Files\\Microsoft Office\\root\\Office16\\EXCEL.exe', 'Excel')