Skip to main content

[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 TypeRequiredDescription
appFileStringYesAbsolute path to the Windows application.
windowTitleStringYesTitle of the opening application windows. Full text, partial text, or regular expression input is acceptable.
matchingStrategyStringMatchingStrategy (enum)OptionalSpecifies 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.

flowControlFailureHandlingOptionalSpecify failure handling schema to determine whether the execution should be allowed to continue or stop.

Returns

Parameter TypeDescription
StepFailedExceptionThrows 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')
Was this page helpful?