I published a project on GitHub
Here I would report a bug found in Katalon Studio v10.4.2.
Environment
- macOS 26.3.1
- Katalon Studio 10.4.2
Steps to reproduce
I created a brand new project of webui.
I created a Groovy file Keywords/com/kazurayam/ks/BrowserMobProxyManager.groovy. The content is as follows:
package com.kazurayam.ks
import com.kms.katalon.core.annotation.Keyword
import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
public class BrowserMobProxyManager {
public static void main(String[] args) {
greeting()
}
@Keyword
public static void greeting() {
WebUI.comment("Hello, i am " +
BrowserMobProxyManager.class.getSimpleName())
}
}
Please note that this class implements a method public static void main(String[]), which caused a small itch later.
I created a Test Cases/TC1. The content is as follows:
import com.kazurayam.ks.BrowserMobProxyManager
BrowserMobProxyManager.greeting()
When I ran the TC1, it worked fine. I saw the following outcome in the console:
2026-04-13 22:14:12.890 INFO c.k.katalon.core.main.TestCaseExecutor - --------------------
2026-04-13 22:14:12.891 INFO c.k.katalon.core.main.TestCaseExecutor - START Test Cases/TC1
2026-04-13 22:14:13.589 DEBUG testcase.TC1 - 1: BrowserMobProxyManager.greeting()
2026-04-13 22:14:13.780 INFO c.k.k.c.keyword.builtin.CommentKeyword - Hello, i am BrowserMobProxyManager
2026-04-13 22:14:13.792 INFO c.k.katalon.core.main.TestCaseExecutor - END Test Cases/TC1
Then, I tried to rename the BrowserMobProxyManger.groovy to WebDriverPlusHARFactory.groovy.
Then a dialog came up and blocked me.
The message said:
Type com.kazurayam.ks.BrowserMobProxyManager contains a main method - some applications (such as scripts) may not work after refactoring.
This warning dialog is not a problem at all. I could understand the message. I could accept the warning. I decided to remove the main method later. But, for the time being, I wanted to ignore the warning. I clicked the continue button. Then, I got a series of problems.
Problem 1: Katalon Studio GUI no longer synced with the file system
In the Katalon Studio GUI, in the Keywords folder, the BrowserMobProxyManager.groovy was renamed to WebDriverPlusHARFactory.groovy. But on the file system, using Emacs editor, I found that the original BrowserMobProxyManager.groovy stayed there and new WebDriverPlusHARFactory.groovy wasn’t present.
Problem 2: the Keyword was renamed, but the Test Case was left unchanged
As long as the BrowserMobProxyManager class was renamed, I expected that Katalon Studio will automatically refactor the Test Case source which refered to the class. I expected that Katalon Studio should change the import statement in the Test Cases/TC1 from
import com.kazurayam.ks.BrowserMobProxyManager
to
import com.kazurayam.ks.WebDriverPlusHARFactory
but, in fact, the Test Case script was left unchanged.
I checked their doc “Introduction to custom keywords in Katalon Studio”. To my surprise, the doc does NOT mention the auto-refactoring of Test Case scripts when a Keyword is renamed. Missing feature it was!
Problem 3: failed to renamed the Keyword back to the original
Next, I tried to rename the WebDriverPlustHRFactory.groovy back to the original BrowserMobProxyManager.groovy.
Then I got an error dialog:
The message said
Type named ‘BrowserMobProxyManager’ already exists in package ‘com.kazurayam.ks’
and actually I could not finish renaming the class back to the original. This was a serious error for me.
Conclusion
Katalon Studio v10.4.2 has some flaws in the renaming of custom keyword classes. I hope Catalon will fix it someday.
