Selenium/TestNG/JUnit Migration to Katalon Studio

This feature is available in version 7.4.0+.

Katalon Studio currently supports executing test cases from Selenium, TestNG, or JUnit projects. You just need to migrate them to a destination Katalon Studio project. By migrating test scripts from Selenium and TestNG/JUnit to Katalon Studio, you don't have to start everything from scratch. You can reuse your test cases and enjoy Katalon features to execute and maintain them.

If it is not preferable or feasible to migrate your existing JUnit/TestNG test projects to Katalon Studio, we recommend integrating JUnit/TestNG and Katalon Studio test projects with Katalon TestOps. This helps you manage test results from multiple sources from a centralized web UI regardless of the testing frameworks the test cases were written in.

This section gives instructions on how to migrate your test scripts from a Selenium and TestNG/Junit project to a Katalon project with newly supported features and keywords. Also, a sample TestNG project is provided to give you first-hand experience with our newly supported features.

Katalon Studio only supports:

Selenium version 3.x
TestNG version 6.11
JUnit version 4.12

Katalon Studio's new features to facilitate the migration include:

Supporting viewing, editing, and creating Java class files under the Include/scripts/groovy folder
Built-in TestNG/JUnit keywords, including:

Run TestNG Test Classes
Run TestNG Test Suites
Run JUnit Test Cases

Keywords details

You can enable the built-in keywords in the manual view by using the TestNG/JUnit Keywords plugin.

After installing the TestNG/JUnit Keywords plugin from Katalon Store, you need to reload the plugin to start using it.

To use this plugin offline, please refer to this instruction.

Please note that the TestNG/JUnit Keywords plugin is a platform plugin; hence, you need to put its jar file in the destination Katalon project folder like so: <project_name>/Plugins/platform.

runTestNGTestClasses

Syntax: runTestNGTestClasses(List testClasses)

Description: run TestNG test classes and generate TestNG report at the running report folder.

Parameters:

Name: testClasses
- Type: List
- Description: List of TestNG classes
- Mandatory: Required
Name: flowControl
- Type: FailureHandling
- Description: an instance FailureHandling that controls the running flow
- Mandatory: optional

runTestNGTestSuites

Syntax: runTestNGTestSuites(List testSuites)

Description: run TestNG test suites and generate TestNG report at the running report folder.

Parameters:

Name: testSuites
- Type: List
- Description: List of TestNG suites as .xml files
- Mandatory: Required
Name: flowControl
- Type: FailureHandling
- Description: an instance FailureHandling that controls the running flow
- Mandatory: optional

runJUnitTestCases

Syntax: runJUnitTestCases(List testCases)

Description: run JUnit test cases and generate JUnit report at the running report folder.

Parameters:

Name: testClasses
- Type: List
- Description: List of JUnit test cases as classes
- Mandatory: Required
Name: flowControl
- Type: FailureHandling
- Description: an instance FailureHandling that controls the running flow
- Mandatory: optional

How to migrate

Below are instructions to help you migrate Selenium/TestNG/JUnit scripts to Katalon Studio as a step-by-step guide or as a video tutorial.

Step-by-step guide

Requirements:

Install Gradle version 5 or prior

To migrate Selenium/TestNG/JUnit scripts to a Katalon Studio project, please do as follows:

Create a project in Katalon Studio, which is the destination for the migrated Selenium/TestNG/JUnit test cases.
Build project dependencies.

2.1 (This step is required only when your JUnit/TestNG project's dependencies are not Selenium dependencies) Open the .gradle file and add Java dependencies of your Selenium/TestNG/JUnit project.

Notes:

Katalon Studio has bundled TestNG, JUnit and Selenium dependencies, so you don't need to declare those dependencies again.

2.2 Open the Command Prompt or Terminal and navigate to the folder of your project. Enter gradle katalonCopyDependencies, then wait for the Gradle to build successfully.

2.3 Reopen the project to reload all the dependencies.
Copy and paste the source code of your Selenium/TestNG/JUnit project in the Include/scripts/groovy folder of your Katalon project.
Copy and paste other resources of your Selenium/TestNG/JUnit project in the root folder of your Katalon project.
Create a test case that includes TestNG keywords to run TestNG test suites or JUnit test classes.