Skip to main content

Katalon Studio Release Notes: Version 9.x

Note:

  • To download the latest version, go to Katalon website: Download Katalon Studio.

  • For Katalon Studio and Katalon Runtime Engine version 9.0.0 onwards, please use the administration domain admin.katalon.com. The "serverUrl" parameter should be specified as serverUrl='https://admin.katalon.com'.

Version 9.7.2​

Release date: September 19, 2024

Enhancements​

  • [TestCloud] Added an option to filter mobile devices with high availability status in the Mobile Recorder, Mobile Object Spy, and TestCloud Configuration dialogs.

  • Adjusted the logic for fetching Organizations and Projects in Project Settings > Katalon Platform.

Fixes​

  • Execution was more likely to be terminated in Katalon Studio version 9.7.1 due to the known limitation that the file path length could not exceed 255 characters on Windows machines.

  • Web service requests took a long time to respond when handling large response bodies.

  • A Please re-authenticate to continue popup appeared after logging in with an expired account and clicking Log in from Browser. This error prevented further login attempts.

  • Override authentication did not fetch the correct project list and displayed You currently have no projects to work on.

  • Wrong behavior when fetching projects with the option Project Settings > Katalon Platform > Override authentication enabled.

  • Error Unable to send request and verify the response when using sendRequestAndVerify with a SOAP request and Auto Detect as the Schema type.

  • [Free edition] An error, InvocationTargetException: Missing organization!, occurred when creating a new TestOps project under Project Settings > Katalon Platform > Integration.

  • [API testing] The Secret Key field in AWS Signature did not mask the input value on the UI.

  • The +, :, and , characters in the web service request URL were not decoded before sending the request in Katalon Studio versions 9.7.0 and 9.7.1.

  • [TestCloud] The Start button was not enabled when switching devices in the TestCloud Configurations section of the Mobile Recorder and Mobile Object Spy dialogs.

  • Failed to upload a report when executing on KRE with On-Premises version 2.1.6.

  • [KRE] [Kobiton] Kobiton integration did not work with Katalon Runtime Engine (KRE).

Changes​

  • In version 9.7.2, we have corrected the behavior of Override authentication for Platform integration and KRE command-line authentication to prevent misunderstandings during activation and integration. Please review the parameters you are using to ensure they follow the correct usage:

    • -serverUrl=<server URL>: Specifies the server URL for KRE license activation.

    • -testOps.serverUrl=<URL>: Specifies the URL for Platform integration.

    • -apiKey=<Your_API_Key> or -apikey=<Your_API_Key>: API keys used for KRE activation.

    • -orgID=<organization's id>: Specifies the OrgID used for KRE activation.

Version 9.7.1​

Release date: August 30, 2024

Fixes​

  • Admin users could not log into Katalon Studio Enterprise 9.7.0 using the Log in from Browser option.

Known limitations​

Version 9.7.0​

Release date: August 28, 2024

New features​

  • [API testing]:

    • Katalon Studio now supports Digest Access authentication for API testing. Learn more at Digest authentication in Katalon Studio.

    • We have also added support for AWS Signature authentication in Katalon Studio. This feature allows secure communication with AWS services by configuring AWS Signature in the Authorization tab of a Web Service request. The feature is available for licensed users. Learn more at AWS Signature authentication in Katalon Studio.

  • For On-premise users, you can now log in from a browser after setting your On-premise server URL in Advanced Settings.

  • Katalon Studio now includes OpenAPI/Swagger schema compliance validation in the Validation tab of a Web Service request.

  • Added a new code snippet to the Verification tab of a Web Service request: Response body: Validate OpenAPI/ Swagger against specification.

  • Added a new keyword for OpenAPI/ Swagger validation: WS.validateOpenAPIAgainstSpecification.

  • Added an option to configure the default element locator value of test objects when using Mobile Recorder and Mobile Object Spy. Access this setting in Project Settings > Test Design > Mobile.

  • Added new KRE command-line options to retry activating licenses several times when KRE failed to activate.

Enhancements​

  • Introduced a new survey during onboarding to help Katalon understand user needs better. The survey appears when logging into Katalon Studio for the first time on a new machine.

  • Now supports importing, validating, and generating API tests with OpenAPI 3.1 specifications, including AI-powered test generation.

  • Upgraded Cucumber library to the latest version of Cucumber 3 to fix slow performance issues when editing feature files.

  • [Windows Desktop testing]:

    • Enhanced the performance of keywords: setText and setEncryptedText.

    • Improved the performance and accuracy of the keywords: switchToWindowTitle and startApplicationWithTitle by supporting regular expression inputs.

    • Supports starting the desktop app in Recorder when using a shortcut file.

  • Embedded WebDrivers have been updated to support the latest browser versions: Chrome 128, Edge 128, Firefox 129, and GeckoDriver 0.35.

  • Katalon Studio now supports mobile testing with iOS 18 beta. You can record, spy, and execute test cases and suites on iOS 18 beta simulators within both Katalon Studio and Katalon Runtime Engine.

Fixes​

  • Unable to Verify and Highlight the element via Active Browser.

  • KRE hanging on Linux after running more than 50 test cases.

  • Object was called in BDD Action steps showed as unused objects.

  • [API testing]:

    • The HTTP Body tab of the GET request was disabled when switching to another method.

    • Unable to send request when leaving the File type fields empty in a form-data body.

    • Object Repository did not auto-refresh to show newly imported endpoints in Katalon Studio Free when turning on the option Auto-generate test cases for endpoints with AI.

    • API URL did not allow %20 as a space character, which caused incorrect encoding.

    • Every JSON object format was considered as JSON schema in the schema validation tab of a Web Service request.

  • Test Suite Collection did not automatically refresh its Test Cases when a new Test Case was added to its Test Suite.

  • Keyword Windows.switchToWindowTitle was unstable.

  • [Intermittent]:

    • KRE could not delete the bin directory and stopped running with error code 2.

    • Randomly logged out of Katalon Studio.

  • [TestCloud]:

    • Error Session ID was null when running multiple test cases on TestCloud.

    • Test suite collection was executed with the wrong profile when using the TestCloud environment.

  • [Web Recorder] Unable to continue recording after deleting all recorded steps and clicking the Resume button.

  • [Mobile]:

    • Error when searching folder while saving objects in Mobile Recorder and Mobile Object Spy.

    • Error when adding an existing object to Mobile Object Spy.

    • Mobile.scrollToText keyword not working on iOS.

    • In Mobile Object Spy, the wrong number of selected objects were saved, and the unsaved objects were unexpectedly removed from the captured objects list.

    • When switching between Attribute and XPath, the value of Attributes was applied for XPath.

    • Locator value was not saved after editing if the locator already had an existing value.

    • [Android] Test object variables in the locator disappeared.

    • [Mobile Recorder] Object was automatically deleted after users changed timeout.

  • [WebUI]:

    • Uncheck Pin Recorder window did not affect on Web Recorder.

    • Objects that have the same attribute were not captured while recording.

    • Multiple test steps were generated for one action when recording on some specific web page.

  • Variable auto-suggestion in Script View was not working as expected.

  • Closing the app when both the access token and refresh token expired, the Release License progress could not end until the user killed the process.

  • Took more than 2 minutes to open the browser when running more than 50 test cases (navigate to website) on Linux/Docker.

  • Unable to generate HTML report when running long API test case with KRE.

  • When renaming the test object in Katalon Studio with only changes in letter case, the test object file name was not synced.

  • Unable to rename Windows object by changing letter case.

  • Adding an external jar through Project Settings > Library Management caused Katalon to glitch or crash.

  • Unable to generate a CSV file when using StudioAssist > Generate code.

  • Null pointer exception when running a test suite and automatically uploading report to TestOps.

  • Unable to capture iframe objects using right-click in Web Spy.

  • Report uploads to TestOps failing when the project was missing the analytics.properties file.

  • [KRE]:

    • Compilation issue Groovy:unable to resolve class CustomKeywords when executing tests in Katalon Studio and KRE.

    • KRE failed to activate license, causing pipeline failures when no license is available.

    • Unable to run Test Suite Collection from KRE with valid TestCloud license and no KRE license.

    • Error System could not generate internal.GlobalVariable file normally when running KRE with a project that has a large number of files in the Reports folder.

    • Error java.lang.StringIndexOutOfBoundsException: begin -1, end 22, length 42 when running BDD project on Linux.

  • [Windows testing] Unable to start the application in Native Window Recorder in Katalon.

  • When adding test cases to the test suite, the option Hide test case already added to test suites was not working as expected if you select the parent folder.

  • Override authentication did not work properly and showed information from the previous organization.

  • [Web] Scripts containing Smart Locator and shadow DOM objects passed on a desktop browser but failed on a mobile browser with the error: Element is not found and returns "Element is no longer attached to the DOM".

  • Error There was an error managing geckodriver 0.35.0 appears when updating web driver for Firefox.

  • Error Unable To Open HTTP Body Editor.

  • The Javadoc of Web Service keywords did not display properly.

  • Shadowroot did not work for some specific cases after upgrading to 9.x.

  • Exclude host in Proxy System setting did not work.

  • Some requests did not have authentication info when configured with Manual Proxy settings.

Changes​

  • [UI Changes]:

    • In the Web Service request, the Configuration tab is removed, and the option Follow redirects is moved to the same line with the option to Set timeout and response size limit. You have an option to enable follow redirect by default for newly created Web Service request in Project Settings > Execution > Web Service. For projects created in 9.7.0 onwards, Follow redirects is enabled by default.

    • In the login dialog, Proxy Settings is now under Advanced Settings, and a new field License server address is added.

  • Log in with SAML SSO: now you need to input the subdomain URL in Advanced Settings > License server address, then click Log in from Browser.

  • Improved the UI of the Project Settings > Library Management page and auto-trigger Save Resources dialog when applying changes while the project contains unsaved items.

  • [Desktop] Use the executable's parent folder as the default app working directory.

  • Added the Onboarding Hub link inside Katalon Studio Enterprise. You can now access it from the Quick Links section and the main toolbar.

Known limitations​

  • [Intermittent] Unable to remove external libraries, it keeps showing the removed ones.

    • Workaround: Go to your project folder, select the Drivers folder and delete the .jar file. Then, close and re-open the project in Katalon Studio to reload the class paths.

  • [API testing] The keyword WS.validateOpenAPIAgainstSpecification is not working as expected in some specific cases.

  • [Offline license] When activate Katalon Studio with an offline license, some unexpected error will happen with TestOps integration if you haven't selected Override authentication and enabled platform integration.

  • Recording Web navigation leads to the wrong URL if Katalon Recorder 7.0.0 is installed in the current browser.

Version 9.6.0​

Release date: June 14, 2024

New features​

Enhancements​

  • Removed the Manage your downloads permission from the built-in Recorder and Smart Wait extension.

  • [Git Integration] Added the .cache/ directory to the .gitignore file to reduce conflicts after pulling the code.

  • Added Chrome 126 and Firefox 127 compatibilities.

  • [StudioAssist] Improved StudioAssist results when generating and explaining code.

  • [Security Compliances]:

    • Updated Eclipse-ECD to the latest version.

    • Added new Docker slim tags: 9.6.0-slim and 9-latest-slim (Docker without Gradle and WebDriverManager).

Fixes​

  • [Spy Web] Unable to spy an active browser using Katalon Compact Utility (KCU) and Katalon Recorder extensions.

  • Failed to download WebDriverManager due to checksum mismatch.

  • [Katalon Windows Installer] Resolved the "Failed to download due to unknown network error" issue.

Known limitations​

  • [API Test Generation]:

    • AI responses can be inaccurate or misleading.

    • The time to generate test cases might be long, depending on your specification and the number of test cases you want to generate.

    • We can only generate status code test cases in the first release.

    • The imported file size limit for API generation is 8MB.

Version 9.5.0​

Release date: May 29, 2024

New features​

  • [TestCloud Integration] You can now use Mobile Recorder & Object Spy with TestCloud devices with a TestCloud mobile native apps subscription.

  • Added the ability to execute test cases, test suites, and test suite collections with mobile native apps on TestCloud devices.

Enhancements​

  • [StudioAssist] Added the ability to use StudioAssist with personal OpenAI and personal Azure OpenAI API key.

  • [TestCloud]:

    • Added a setting page in Project Settings for configure TestCloud desired capabilities.

    • Revamped the TestCloud Configuration dialog so you can easily choose between 3 types of TestCloud environment.

    • Added a Shared Tunnel toggle in the TestCloud Tunnel Setup Helper dialog.

    • Displayed available TestCloud subscription when enabling TestCloud integration.

  • Improved the performance of API test execution.

  • Enhanced the HTML and PDF report file to display detailed info of TestCloud and mobile environments.

  • Added the ability to modify generated locator in Mobile Recorder & Spy and test object.

  • Added new Katalon Docker tags for the latest v9.x.

  • Added Chrome 125, Edge 125, and Firefox 126 compatibilities.

  • [Security Compliances]:

    • Upgraded DOM4J to version 2.1.4.

    • Upgraded logback-core-1.2.3.jar and logback-classic-1.2.3.jar.

    • Upgraded org.eclipse.jetty:jetty-http.

    • Upgraded io.swagger:swagger-parser to version 2.1.21.

    • Upgraded PostgreSQL to 42.7.3.

    • Upgraded WebDriverManager to 5.8.0.

    • Updated Jackson core and databind.

    • Upgraded Apache Commons: IO to version 2.15.1 and Compress to 1.26.1.

    • Updated org.json to version 20240303.

    • Updated Apache HTTP client to 4.5.13.

    • Upgraded GraphQL dependencies.

    • Upgraded netty-all to version 4.1.109.

    • Upgraded logback-core-1.2.3.jar and logback-classic-1.2.3.jar.

    • Upgraded the okhttp and okio.

    • Upgraded zip4j library.

    • Incorporated custom cucumber build with resolved vulnerabilities into the pipeline.

    • Used the stripped version of the Selenium standalone server without SnakeYAML.

Fixes​

  • Unable to open test suite after terminating a test suite collection.

  • Unable to open test suite after renaming its reports folder.

  • Unstable issue with CustomKeyword after upgrading to version 9.3.1.

  • [Mobile] Unable to capture other objects that have the same XPath.

  • Automatically added Switch to Window Title actions when clicking on Web Recorder.

  • WebDriverManager downloaded the wrong driver version because it could not detect the browser version in Docker.

  • Unable to import OpenAPI 3 for some specific files.

  • WebUI.findWebElement was not working the same as in 8.x.

Changes​

  • [UI Changes]:

    • Added back the StudioAssist icon on the main toolbar with new look.

    • Merged the TestCloud and TestOps icons on the main toolbar into one Platform integration icon.

    • Revamped Mobile Object Spy dialog.

  • When you click Log in from Browser, Katalon Studio opens an embedded login form instead of a new browser tab.

  • When AI features setting is disabled in your account, you cannot use StudioAssist with the Katalon AI service, but you can still use StudioAssist with personal OpenAI and Azure OpenAI key. See StudioAssist Preferences.

Known limitations​

  • Unable to create a session when Record/Spy on TestCloud devices if you are behind a proxy. You might need to import the proxy certificate to Katalon Studio package. See Set proxy certificate when connecting to remote devices.

  • Unable to use Web Recorder/Spy on active browsers with Katalon Recorder installed. Workaround: When selecting an Active Browser but the session does not initiate, click the Spy with Active Browser button again to establish the connection.

  • Embedded universal log-in form:

    • Once you log in with GitHub, you cannot switch to another GitHub account.

    • If you want to change to another SAML account, you need to log out, quit Katalon Studio, then restart and login again with the other SAML account.

    • Some links like terms and policy cannot be opened from the embedded universal log-in form.

    • Unable to log in successfully when pressing Ctrl and click some buttons on the embedded universal log-in form and log in from a new dialog on a Windows machine.

    • Unable to login after turning on network proxy which has authentication. Workaround: You need to select Manual proxy configuration to continue.

    • For some cases, when failing to log in with an account while using Log in from Browser, you might need to quit and restart Katalon Studio, and log in with another account.

  • [TestCloud Integration]

    • The start Existing Application keyword is not yet supported when running with the TestCloud mobile native app.

    • Highlighting objects is sometimes incorrect on TestCloud iPad devices.

    • When recording and spying with TestCloud devices, the default timeout is in the range of 60-120s depending on the device.

    • When opening a project that has the Override authentication configured in Katalon Platform Integration, the TestCloud subscription info might be incorrect.

    • Sometime, the TestCloud subscription info in Project Settings is incorrect if you log out and log in to another account in the same session. You might need to check/uncheck the Katalon TestCloud Integration option to refresh the correct info.

    • For some specific devices, the TestCloud recorder/spy and execution takes up to 15 minutes to start the app.

Version 9.4.0​

Release date: April 4, 2024

Enhancements​

  • You can use StudioAssist without having to input your own OpenAI API key once the AI settings is enabled.

  • You can now import OpenAPI 3.0.x with a URL.

  • [UI Changes]:

    • Combined the Import from OpenAPI and Import from Swagger options into one dialog called Import REST request from OpenAPI.

    • Improved error message when loading a file that is not in JSON or YAML format.

  • Added the option to enable or disable Smart Locator. When disabled, Katalon Studio will not install Smart Locator extension when executing and using Self-healing.

  • For mail server that already set up successfully to use without password, you can send report via email without having to input the password in Project Settings.

  • Test executions run under Debug mode are not counted against Platform Test results quota. This means after running under Debug mode:

    • Execution results are not uploaded to TestOps even with Platform integration enabled

    • Basic reports (HTML, PDF, CSV file) are not generated automatically

    • The option to export basic reports manually is disabled.

  • [Mobile Recorder & Spy]:

    • Enhanced the Accessibility ID object locator. You can now generate Accessibility ID in Recorder and Test Object editor.

    • [Kobiton integration] Added the option to start with application ID or application file of the Kobiton device.

  • Added Chrome 123, Edge 123 and Firefox 124 compatibilities.

  • [Security Compliances]:

    • Upgraded Gradles from 5.4.1 to 7.6.4.

    • [Jenkins integration] Upgraded org.jenkins-ci.main:jenkins-core from v2.361.4 to 2.448.

Fixes​

  • Web Recorder & Web Spy stopped working after a few minutes.

  • Did not display expiration date in About Katalon Studio dialog.

  • Displayed the wrong expiry date.

  • [Linux] Invalid machine ID when creating offline license.

  • Trial accounts were unable to execute with KRE when including -orgID in the command.

  • Unable to load Katalon Store plugins in Katalon Studio.

  • [Kobiton integration] Unable to use Mobile Recorder with private URLs.

Known limitations​

  • StudioAssist is not available for use when logging via License server and Offline license.

Version 9.3.2​

Release date: March 15, 2024

Changes​

Katalon Studio is now available in two editions: Katalon Studio Enterprise (KSE) and Katalon Studio (KS) Free.

The Enterprise edition is the suitable solution for larger organizations and businesses requiring advanced functionality and premium support. The Free edition is designed to provide basic features to individual users and small teams. To learn more about the difference between the two editions, see Katalon Studio vs Katalon Studio Enterprise Features.

Depending on your license type, you can only log in to certain Katalon Studio editions and versions.

Activate Katalon Studio Edition

Activate Katalon Studio Enterprise EditionActivate KS Legacy(**)
Free users(*) who logged in with legacy editions✅❌✅
Free users who NEVER logged in with legacy edition✅❌❌
Trial KSE users who logged in with legacy edition✅✅✅
Trial users who NEVER logged in with legacy edition✅✅❌
Paid KSE users✅✅✅
Note:

  • (*)Free users are those NOT violating the Free Offering policy in Katalon Customer Terms of Use.

  • (**)KS Legacy includes all Katalon Studio versions prior to v9.3.2.

  • If you're a Trial user or have a KSE license and using Katalon Studio version from 9.0.0 to 9.3.1, you can in-app upgrade to Katalon Studio Enterprise 9.3.2.

  • If you are in free period, in-app upgrade from 9.0.0 - 9.3.1 to Katalon Studio Free is not supported. You need to download Katalon Studio Free at Katalon download page to continue using.

There are also minor changes to the UI of the two editions:

  • Removed the License server and Offline license options in Katalon Studio Free.

  • Changed the login dialog name of Katalon Studio Enterprise to Welcome to Katalon Studio Enterprise.

Enhancements​

  • Added the ability to automatically update WebDriverManager.

Version 9.3.1​

Release date: February 28, 2024

New features​

  • [KSE] Introduced a new selection method: Smart Locator to improve object recognition of complex shadow DOM and iframe. The selection method is added to Web Recorder & Spy, and Self-healing. See Smart Locator.

Enhancements​

  • Added links to Documentation and Academy pages in the Help menu for better accessibility.

  • Improved performance when renaming simple forms of files, including test case, test suite, test object, data file, check point file, feature file, and test listener.

  • Added Chrome 122, Edge 122 and Firefox 123 compatibilities.

Fixes​

  • Added the wrong number of test cases to the test suite when users check and un-check to show or hide added test cases.

  • Got compileGroovy FAILED error when executing the Gradle command with Katalon Studio 9.x.

  • Displayed two dialogs when both Access Token and Refresh Token were expired at the same time.

  • Unable to get access token with OAuth 2.0.

  • Unable to automatically update Chrome WebDriver to versions 121 and 122.

  • Running valid JUnit test with TestNG built-in keyword did not pass.

  • [Intermittent] Error occurring when running a test suite in KRE.

Version 9.3.0​

Release date: February 1, 2024

New features​

  • You can now log in to Katalon Studio using SAML SSO and custom SSO via Katalon login form.

Enhancements​

  • Supported WebUI.Authenticate keyword on macOS and Linux with Chrome, Edge Chromium, and Firefox.

  • [Web Recorder]:

    • Support capturing and highlighting elements when switching to another tab or window.

      When there is a new browser tab or window open, you can:

      • Capture XPath in the new tab/window precisely.

      • Verify and Highlight newly captured objects normally.

    • Support recording the Set Text action in Rich Text Editor. The input of Set Text in Rich Text Editor includes the HTML tags (outer HTML).

      The content we support:
      • normal text
      • bold, italic, underline, link
      • font, size, color
      • image (partially - some temp image links might not work)
      • special characters

  • Support using WebUI.getText keyword on Rich Text Editor. The output of this keyword is plain text only (inner HTML).

  • Improved the mechanism for generating heavy HTML reports. The recommended size for an HTML report is under 512MB. You might encounter the error java.lang.OutOfMemoryError: Java heap space if exceeding the limit.

  • Added username and password fields to the Log in with License server dialog.

  • Upgraded Katalon Compact Utility to Manifest V3.

  • Added Chrome 121 and Gecko 0.34 compatibilities.

Changes​

  • Removed Team options in UI. For On-Premises users, the option is still available.

  • Removed the "Load DOM Map" instruction from Web Spy.

Fixes​

  • [UI] Text in dark themed Script editor and Console log was difficult to read.

  • Unable to capture the XPath of an SVG tag.

  • Unable to close the app with Mobile.closeApplication keyword after running a mobile test script that used Mobile.startExistingApplication.

  • Some codes were deleted when switching between Manual and Script mode.

  • [Web Recorder] When an action opened a new tab, Recorder captured the wrong order of command and its title.

  • [Web Recorder/KCU] Unable to record WebUI.selectOptionBy keywords between two combo-boxes on Edge Chromium and Chrome.

  • Web Spy/Recorder stopped working after a few minutes.

  • [Mobile Recorder] Failed to save test scripts with object ID or file path exceeding 255 characters.

  • [KRE] Unable to execute tests and error java.lang.NullPointerException: Cannot invoke "java.lang.Exception.getMessage()" thrown if the -apiKey was only specified in the console.properties file.

  • Unable to execute tests with Firefox 121 on macOS.

  • Unable to open browsers with Firefox 121 on Recorder/Spy on macOS.

  • Automatically logged out every 2 days if you logged in with Katalon email and password in version 9.x.

Known limitations​

  • WebUI.setText action in Rich Text Editor might not work as expected when:

    • Switching between different editor types

    • On Firefox, you have to click outside the rich text editor to complete recording that action

    • On Firefox, adding an image in rich text editor will add an extra <p> tag to the recorded script

    • Able to capture the rich text editor, but unable to Set Text on Draft.js

    • Able to set text, but each set text action generates 2 duplicated steps Editor.js

    • Unable to capture rich text editor on Rich Text Editor Demos

  • Override authentication option is not supported for SAML login.

  • Web Recorder & Spy will not work as expected if you leave them open without interacting for 1 hour.

  • Unable to execute test with Firefox 121 installed from Snap on Linux. To troubleshoot, see Unable to run tests with Firefox 121.

Version 9.2.0​

Release date: December 28, 2023

New features​

  • You can now log in to Katalon Studio with a GitHub account. This update is also available for version 9.0.0 and 9.1.0.

  • [Katalon Runtime Engine]:

    • You can now execute test suite and test suite collection with TestCloud mobile browser environments. We recommend using Command Builder to generate mobile browser commands with correct mobile device names.

    • Added the ability to override with TestCloud environment for all test suites in a test suite collection when executing.

  • [Mobile] Added support for iOS 17 and Xcode 15.

  • [Mobile Recorder/Spy] Added an option in Project Settings to display the full element in the object tree while recording/spying on mobile native iOS apps.

Enhancements​

  • Added Edge 120, Chrome 120, and Firefox 120 compatibilities.

Changes​

  • [UI] In TestCloud Configuration dialog, changed Execute with Tunnel for private domain testing on Desktop Browsers or Mobile Browsers to Private/ Local testing.

Fixes​

  • [KRE] Unable to release license when using the -licenseRelease=true -orgID=xxxxxx parameter in the command.

  • [Mobile Recorder/Spy] Object tree did not display to capture with the BrowserStack remote device.

  • [Web] Recorder stopped generating new steps after adding a custom keyword.

  • [TestCloud] Error 'java.util.NoSuchElementException' while getting appending additional signature when executing with TestCloud environment.

  • Tokens expired which required logging in again every 2 days.

  • Unable to get access token with OAuth 2.0.

Version 9.1.0​

Attention:
  • Katalon Studio is not compatible with macOS Ventura 13.1 Intel. To use Katalon Studio 9.1.0, please upgrade your macOS to version 13.6.1.

Katalon Studio 9.1.0 offers two major updates, which are the official support for Appium 2.x, and the transition of custom keywords into an exclusive Enterprise feature.

Release date: November 30, 2023

New features​

  • Katalon Studio now supports Appium 2.x for mobile testing. Learn more at Execute mobile tests with Appium 2.x.

  • Added support for iOS 16 and Xcode 14 for iOS mobile testing.

  • [WebUI] Introduced navigateToMaskedUrl keyword. See [WebUI] Navigate to masked URL.

  • Introduced an option in Project Settings > Execution to hide hostname in test reports and log viewer.

Changes​

  • Features related to custom keywords are now exclusively available for Enterprise users. This includes functionalities such as adding new custom keywords or packages, executing tests with custom keywords, using custom keywords in manual mode and the recorder, as well as loading custom keywords within the project.

  • [UI] Tools > iOS is now Tools > Set up iOS environment.

  • [Mobile Spy/Recorder] Cloud Application ID is now Application Path/ ID and an optional field.

Enhancements​

  • [Mobile] Added more instruction for iOS WebDriverAgent installation.

  • [Mobile Spy/Recorder] Supported identifying duplicated object.

  • [Plugins] Upgraded to Manifest V3 for Katalon Studio extensions and Smart Wait utility.

  • In the generated JUnit_Report.xml file, the test suite timestamp dateTime data type changed from YYYY-MM-DD hh:mm:ss to YYYY-MM-DDThh:mm:ss (T indicates the start of the required time section).

  • WebUI.setMaskedText keyword can now mask text in the step name of console log, log viewer and test reports.

  • Added Edge 119, Chrome 119, and Firefox 119 compatibilities.

  • [Security Compliance] Upgraded babel/traverse to version 7.23.3.

Fixes​

  • [iOS] Captured Xpath incorrectly.

  • [On-premise] Unable to log in to Katalon Studio with machines that have duplicated machine IDs.

  • [On-premise] Unable to activate KRE license from Pipeline.

  • [KRE] Unable to override with local execution environment for test suite collection.

  • [Web Recorder] Unable to record steps with shadow DOM on Edge Chromium.

  • [Windows] Katalon Studio was not responding after adding a keyword if the display systems setting was larger than 100%.

  • [Windows] [Intermittent] Error 'Unable to open project. Reason: Resource Exception' when closing and then opening a project with a new account.

  • Katalon Studio version 9.0.0 crashed on a few specific devices.

  • Option Take Screenshot when execution failed in Project Settings > Execution did not work in mobile test cases that contained CONTINUE_ON_FAILURE.

  • [Mobile Recorder] Unable to perform Mobile.setText keyword and Set Text action on an EditText element of Flutter app.

  • 'Unable to start appium after 60s' error appeared when starting Mobile Recorder/Spy after setting up the test environment with Homebrew.

  • Using Mobile.takeScreenshot keyword while executing took more than 90 seconds to complete with warning error messages.

  • When using Mobile.takeElementScreenshot keyword, the log viewer showed passed result, but no images were captured.

  • Mobile.takeScreenshotAsCheckpoint:

    • Did not highlight the selected element accurately.

    • Using the keyword also captured the status bar.

  • Some mobile keywords did not work on Emulator Android 13, Android 14 with the error: 'Caused by: org.openqa.selenium.UnsupportedCommandException: Not implemented'.

  • Error 'Cannot invoke "com.kms.katalon.core.driver.DriverType.getName()" because "browser" is null' displayed when running the following keywords: takeScreenshotAsCheckpoint, takeFullPageScreenshot, takeFullPageScreenshotAsCheckpoint with remote server URL.

  • [BrowserStack]:

    • Unable to integrate with BrowserStack under a specific VDI proxy.

    • Error "Unable to make field private final java.lang.String java.util.logging.Level.name accessible" displayed when running mobile browser test on Android device.

  • Unexpected issues occurred when the access token expired but the activation code was still valid, for example, unable to manage API key from the profile, unable to fetch the Platform dashboard, unable to get API key from the Command Builder dialog.

  • Typo mistake in the title of the Upgrade Firefox WebDriver dialog.

Known limitations​

  • Mobile.takescreenshotAtCheckpoint keyword is not working properly on Pixel 6 pro simulator.

  • For some specific remote devices on Kobiton and LambdaTest, Mobile.takeElementScreenshot keyword can only screenshot half of the element.

  • You might see this error: 'Periodic workspace save.' has encountered a problem. You can click OK and continue working with Katalon Studio normally.

  • Unable to open browser with URL when executing with Chrome/Edge Chromium on Docker hosted on some specific Intel macOS machines.

  • [Linux][BDD tour] Unable to interact with Katalon Studio after click Upgrade now button.

Version 9.0.0​

Katalon Studio 9.0.0 is developed from version 9.0.0.beta and contains all the changes in 9.0.0.beta. To learn more about the changes in 9.0.0.beta, see Version 9.0.0.beta.

Note:
  • In-app upgrade from 8.x to 9.0.0 are not available due to the major changes. You will need to manually download version 9.0.0 from the website.
  • When upgrading from 8.x to 9.0.0, you might need to perform some additional steps for a smooth transition. For more details, see Migrate Katalon Studio from 8.x to 9.0.0.

Release date: October 24, 2023

New features​

  • Introduced StudioAssist - the AI assistant inside Katalon Studio. StudioAssist was initially introduced in 8.6.7.beta and is now officially supported, with bug fixes and improvements. To learn more about StudioAssist, you can refer to StudioAssist in Katalon Studio.

  • You can now log in to Katalon Studio with a Google account.

Enhancements​

  • [Performance] Result may vary based on your situation, but we've observed significant improvements in Katalon Studio:

    • Large projects startup time is reduced by 82%.

    • Test suite execution time is reduced by 25%.

  • [UI Changes] Updated the Katalon Studio activation dialog with a minimalist design and cleaner look.

  • [Mobile Recorder & Spy] Enhanced the highlighting mechanism: When hovering over any element, Katalon Studio also highlights other interactable elements under it.

  • [Web Recorder & Spy] Supported recording and spying elements on web pages that are iframes nested in Shadow DOM, and Shadow DOM nested in iframes.

  • Added a sample project for StudioAssist to provide guidance on common use cases. For more information, see Sample StudioAssist project.

  • Added Chrome 118, Edge 118, and Firefox 118 compatibilities.

  • Minor improvements for the onboarding tour.

Changes​

  • Quickstart guide is now Studio Walkthrough.

Fixes​

  • Unable to switch on iframe automatically for 3 keywords: WebUI.getCSSValue(findTestObject, text), WebUI.findWebElement(findTestObject, N) and WebUI.findWebElements(findTestObject, N).

  • Displayed java.lang.ClassCastException: java.lang.Double cannot be cast to java.lang.Long error when using scrollToElement keyword before WebUI.takeScreenshotAsCheckpoint on Web and mobile browser.

  • [Intermittent] Displayed An error occurs when generating global variables for email config. error in the console log.

  • [Mobile Recorder & Spy] Incorrect test object highlight when using on iOS 15 and 16.

  • Katalon Compact Utility became unresponsive on some AUTs.

  • [Windows][Web Recorder] Recording on a ServiceNow site caused the Recorder to hang.

Known limitations​

  • [Windows][Performance] Consume more memory when opening project than 8.x versions.

  • [Intermittent] Katalon Studio displays the error dialog: "Refresh DSLD scripts" when loading projects. This error does not affect your projects. You can close the dialog and use Katalon Studio normally.

  • [Windows Server 2016] You might not be able to open Start Page and Quickstart guide and encounter this error org.eclipse.swt.SWTError: Not implemented [WebView2 runtime not found]. For workaround, see Cannot open Start Page and Quickstart guide in Windows Server 2016.

  • Error java.lang.UnsatisfiedLinkError when running WebUI.verifyImagePresent keyword with Katalon Studio for macOS (Apple Silicon). Workaround: Download and use Katalon Studio for macOS (Intel) instead.

Version 9.0.0.beta​

Release date: September 13, 2023

Enhancements​

  • Upgraded Eclipse IDE from version 4.16 to 4.27 (2023-03).

  • Upgraded Java from version 8 to 17. For Linux users, you will need to upgrade OpenJDK to version 17.

  • Upgraded the Groovy compiler from version 2.4.2 to version 3.0.17.

  • Upgraded EGit from version 4.6.1 to 6.5.

  • [Git integration] Added support for RSA SHA-2, ECDSA and Ed25519 SSH keys.

  • [Web Service] Allowed saving OAuth 1.0 and OAuth 2.0 authentication information of a Web Service Request after closing the object tab.

  • [Jira Integration] Published Jira plugin version 1.0.24 to be compatible with Studio 9.x. If you are using Studio version 8.x, you need to use Jira plugin version 1.0.23 or before.

  • Added partial support for Katalon Studio on Mac with Apple Silicon (Katalon Runtime Engine is not yet supported).

  • Added Edge 116 and Firefox 116 compatibilities.

  • [Windows] Improved the Start Page performance.

  • [Security Compliance]:

    • Upgraded TestNG to version 7.8.0.

    • Upgraded jna-platform to version 5.12.1.

    • Upgraded commons-collections:commons-collections to version 3.2.2.

    • Upgraded ivy-2.4.0.jar to org.apache.ivy:ivy:2.5.1.

Changes​

  • The import and export custom keywords feature is only available for Enterprise users.

  • Without KSE licenses, you can only create 40 test suites per project. Free users with existing projects of more than 40 test suites can still execute their test suites, but cannot create new ones.

  • [BDD] Setting the default package is required. You need to add a @BeforeTestCase listener to the Test Listener file in order for the BDD projects to work as before. Refer to Set the default package for step definitions.

  • When using Katalon Docker Image (KDI) or executing KRE in CI/CD pipelines, if you use the 'latest' tag for the KRE version, you will download the latest version of Katalon Studio 8.x. To use version 9.x, simply replace 'latest' with your desired version number, such as 9.0.0.beta.

Fixes​

The following fixes are integrated when you download/upgrade to Katalon Studio 9.0.0.beta:

  • Error when releasing license in Katalon Runtime Engine version 8.6.5.

  • Error "java.lang.NullPointerException" appears while recording on specific machines.

  • [Web Recorder]:

    • During recording, some pages with iframes were unable to load.

    • [macOS] A blank page displayed when using the Recorder in Write your first test case onboarding tour.

  • Unable to select custom keywords in the Manual view in large projects.

  • [Windows] Katalon Studio was not responding when opening another project after a few times using Open Declaration on keywords or methods.

Known limitations​

  • Warning message in the Problems tab: "The compiler compliance specified is 1.8 but a JRE 17 is used" when opening an 8.x project for the first time in 9.0.0.beta. This message does not affect your project and will no longer display when you reopen your project or create a new project in 9.0.0.beta.

  • [macOS] [Intermittent] When opening an 8.x for the first time in version 9.0.0.beta on a macOS machine, you might see this error message in the Problem tab: "Groovy: compiler mismatch: project level is 2.4, workspace level is 3.0". This message does not affect your project and will disappear when you close the project and reopen it again.

  • [Recorder] Click on IE option in Recorder can make Katalon Studio hang. Workaround: Kill Katalon Studio and open again.

  • [Groovy 3.0.x] Do-While Loop, Lambda expressions, and ARM Try with resources are not yet supported.

  • [BDD] Cannot use custom keywords.

  • [Mobile] Unable to run test with iOS on macOS Ventura with XCode 14. For workaround, see Unable to execute tests with iOS on macOS Ventura and XCode 14.x.

Was this page helpful?