Skip to main content

Katalon Studio Release Notes: Version 10.x

Note:

  • In-app upgrade to version 10.x is not available. To download the latest version 10.x, go to Katalon website: Download Katalon Studio.

  • Katalon Studio 10.x now adopts Selenium 4, bringing major changes to align with the W3C WebDriver standard. For a complete overview of these updates and required migration actions, see Migrate Katalon Studio from 9.x to 10.0.0.

  • Windows Desktop application testing is temporarily unavailable in version 10.x. For more details, see FAQs.

  • Custom keywords have been reintroduced in the free edition starting from version 10.0.0.

Version 10.0.0​

Release date: October 30, 2024

New features​

  • Upgraded Katalon Studio to Selenium 4.22.

  • Upgraded Java Client to version 9.23.

  • Upgraded Appium server to version 2.11.1.

  • Updated drivers' versions:

    • Appium XCUITest Driver for iOS: 7.21.1

    • Appium UiAutomator2 Driver for Android: 3.7.0

  • [Smart Wait and Smart Locator]:

    • You can now execute scripts containing Smart Locator without installing an extension.

    • You can now execute scripts using the Smart Wait function without installing an extension.

    • Added support for enabling or disabling BiDi by adding the following desired capability: "webSocketUrl": true/false.

  • Added support for mobile testing with iOS 18 official.

  • Added new keywords:

    • WebUI.newTab

    • WebUI.scrollFromViewportOffset (beta)

  • Added support for Katalon Runtime Engine Docker image on the ARM64 platform.

Enhancements​

  • Added the Excludes field to the Proxy setting in the Login dialog.

  • [TestCloud]:

    • Added the option to record, spy, and execute with randomly selected high-availability mobile devices.

    • Added the ability to view and execute with private devices on TestCloud.

  • Added Chrome 130, Edge 130, and Firefox 131 compatibilities.

  • [Security Compliance]:

    • Updated WebDriverManager to version 5.9.2.

    • Addressed multiple high-severity CVEs in dnsjava-2.1.8.jar.

    • Upgraded graphql-java_17.5.0.jar to newer version.

Fixes​

  • Error when running recorded test steps on Web Recorder for the second time.

  • [Email report] Unable to send email reports to recipients configured in the test suite while executing tests with KRE.

  • Alert and confirmation dialogs disappeared too quickly for WebUI.acceptAlert to interact.

  • [Web Testing]:

    • switchToWindowTitle took too long to execute.

    • Issue with width/height returned when using getViewportHeight & getViewportWidth.

  • [Test Cloud]:

    • TestCloud Device list was not reset to the first OS version when switching OS.

    • Medium/low selected device was not retained when reopening the run dialog.

    • -orgID showed different values in the command line and TestCloud log information.

  • Enable Katalon Platform Integration automatically enabled after closing the TestOps integration dialog.

  • Katalon Studio unable to detect dateutil in scripts.

  • [Mobile]:

    • Issues with Mobile.swipe keyword.

    • Mobile.pinchToZoomInAtPosition keyword not working.

    • [Mobile Recorder] Error during Swipe action in Recorder tool when using Appium 2.x.

    • Not able to swipe pop-ups.

    • Mobile] Tooltip display issues and difficulty clicking See document hyperlink.

    • Error when double-clicking an object in Mobile Recorder.

    • Mobile.dragAndDrop keyword not working on Android Emulator.

  • Open notification in iOS partially dragged instead of fully opening.

  • [Remote] Recorder/Spy tools unresponsive when starting a remote session without Application Path/ID.

  • Incorrect Custom Desired capability for Edge.

  • Object data type changes on formatting test file with Ctrl + Shift + F.

  • Unable to track dynamic test suite and data binding.

  • Previously opened tabs not automatically reopened in Katalon Studio, except Test Cases tabs.

  • Multi-threading issues in Katalon Studio version 9.x.

  • Import from OpenAPI/Swagger icon on the main menu disabled when navigating to Verification or Validation tab.

  • WARNING: The 'isStretchWithOverflow' attribute is deprecated. Use the 'textAdjust' attribute instead. was thrown when generating PDF reports on 9.7.0.

  • Added HTTP Header was removed automatically after modifying HTTP Body in a Web Service Request.

  • Close and Close & Clean up project options did not work when there was an unsaved Test Suite Collection.

  • About dialog showed null in its title.

  • Take Screenshot when execution failed option was turned off by default.

  • Recorded scripts could not be executed on Katalon Recorder.

  • Error faultCode=PARSER_ERROR:....Invalid byte 1 of 1-byte UTF-8 sequence. occurred when running SOAP requests with validation.

  • Clicking Explore Analytics in Studio Walkthrough did not initiate any action.

  • Installer for Katalon Studio Enterprise and Katalon Studio extracted with duplicate folder names.

  • [Git integration] Tracking branch was changed after pulling code from a different branch.

  • [API] Missing space between Bearer and token occurred when adding Bearer Authorization Header.

  • Only one local plugin was loaded when reloading plugins.

  • [Mac] Web Recorder window was minimized when clicking Record button or rerunning the recorded script.

  • Use system proxy configuration option did not work on Windows.

  • Error occurred when logging into Katalon Studio with proxy set to use .pac file.

  • Excludes value required reloading after saving and reopening advanced settings.

  • Log parsing errors in HAR file were encountered.

  • Plugin did not reload when running Katalon Runtime Engine with TestCloud license only.

  • Internal error occurred during Downloading Update...". 'byte[] org.apache.commons.io.IOUtils.byteArray() when downloading version 9.7.2 from 9.6.0.

Changes​

  • Application names updated:

    • Free Edition: Katalon Studio

    • Enterprise Edition: Katalon Studio Enterprise

    • Apple Silicon Chip: Removed the Arm64 suffix.

  • Updated MobileBy to AppiumBy class.

  • Adjusted offline license and On-Premises flow where login dialog is triggered.

  • Ordered test cases alphabetically in Dynamic Test Suite.

  • Any test case referencing SmartWaitWebDriver will encounter a runtime error as the class has been removed.

  • Updated WebUI.setViewPortSize to align with WebUI.getViewportWidth and WebUI.getViewportHeight, ensuring consistent viewport size results.

  • The licenseServer.properties file has been removed as of version 10.0.0.

  • Corrected the behavior of setViewportSize to ensure that the values returned by getViewportWidth and getViewportHeight are consistent with the dimensions set by setViewportSize. Note: When using the --window-size in Desired Capabilities, getViewportWidth and getViewportHeight may return different values because this setting adjusts the window size, not the viewport size.

  • Based on Selenium 4 documentation, test capabilities that are not structured to be W3C compliant may prevent a session from starting. The following list outlines the W3C WebDriver standard capabilities:

    • browserName

    • browserVersion (replaces version)

    • platformName (replaces platform)

    • acceptInsecureCerts

    • pageLoadStrategy

    • proxy

    • timeouts

    • unhandledPromptBehavior

  • Any capability not listed above must include a vendor prefix. For example, when running on TestCloud, using app and deviceName in desired capabilities can disrupt the session creation process. The correct format for custom capabilities requires a vendor prefix, such as katalon:option for Katalon.

Known limitations​

  • Katalon Compact Utility (KCU) is not supported with BiDi due to a Chrome limitation with profile management.

  • When using BiDi, a BiDi-CDP Mapper tab opens to start the connection.

  • BiDi does not work with Incognito mode in Chrome and Edge Chromium. Attempting to open a session in Incognito mode with BiDi enabled causes the browser session to open briefly and then close automatically. This issue affects: Chrome, Edge Chromium, and Chrome Headless. Workaround:

    • Set webSocketUrl = false in desired capabilities to disable BiDi if Incognito mode is required.

  • BiDi does not work with custom profiles in Chrome and Edge Chromium. Attempting to open a session with a custom profile and BiDi enabled causes the session to fail with an initialization error.

  • Docker image on linux/arm64 supports Firefox version 129 instead of the latest version 131.

  • Removal of AbstractEventListener, EventFiringWebDriver, and WebDriverEventListener in Selenium. Follow Selenium documentation to migrate test scripts that use these classes: Removal of AbstractEventListener + EventFiringWebDriver + WebDriverEventListener.

  • Simple Dialog (alert/prompt) handler behavior: The unhandledPromptBehavior capability, which defaults to "dismiss and notify" per W3C standards, dismisses simple dialogs automatically. Workaround:

    • Set unhandledPromptBehavior to ignore so that you can handle dialogs manually.

  • Install dependencies: Node installation failed during dependency setup, including manual installation (without Katalon Studio). A warning may appear stating, The post-install step did not complete successfully. Workaround:
    • Run the following commands to resolve the issue:
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
      brew update
      brew uninstall node
      brew install node
Was this page helpful?