com.kms.katalon.core.webui.exception.BrowserNotOpenedException: Browser is not opened error is displayed for chromeDriver in Katalon 10.2.1

Product Forums Katalon Studio
1

Caused by: com.kms.katalon.core.webui.exception.BrowserNotOpenedException: Browser is not opened

Build info: version: ‘4.28.1’, revision: ‘73f5ad48a2’

System info: os.name: ‘Windows 11’, os.arch: ‘amd64’, os.version: ‘10.0’, java.version: ‘17.0.14’

Driver info: driver.version: un

1 Like
2

The BrowserNotOpenedException in Katalon Studio typically occurs when the browser driver (e.g., ChromeDriver) fails to launch the browser due to compatibility issues, configuration errors, or environment problems. Let’s troubleshoot this step-by-step:

1. Browser/Driver Version Mismatch

This is the most common cause. Your Chrome browser version and ChromeDriver version must be compatible.

  • Check your Chrome version:
    • Open Chrome, go to chrome://version/ (e.g., 120.0.6099.130).
  • Check Katalon’s bundled ChromeDriver:
    • Navigate to Katalon’s plugins folder:
<Katalon_Installation_Folder>\plugins\org.openqa.selenium.chrome.driver_*.jar
  • Extract the JAR file (e.g., using 7-Zip) to see the ChromeDriver version (e.g., 120.0.6099.109).

Solution:

  • Update ChromeDriver to match your Chrome browser:
    • Download the correct ChromeDriver from ChromeDriver Downloads.
    • Replace the existing ChromeDriver in Katalon’s plugins folder.
  • OR downgrade your Chrome browser to match the existing ChromeDriver.

2. Browser Configuration Issues

Chrome Options

Ensure your script’s Chrome options are valid. Example of a working configuration:

groovy

import org.openqa.selenium.chrome.ChromeOptions  
import com.kms.katalon.core.webui.driver.DriverFactory  

ChromeOptions options = new ChromeOptions()  
options.addArguments("--no-sandbox")  
options.addArguments("--disable-dev-shm-usage")  
options.addArguments("--remote-allow-origins=*")  // Required for Chrome v111+  
options.addArguments("--start-maximized")  

// Start browser with options  
WebUI.openBrowser('')  
WebUI.navigateToUrl('https://your-site.com')

Avoid Conflicts

  • Close all Chrome instances manually before running tests.
  • Disable other Chrome extensions during testing.

3. Environment Issues

  • Chrome not installed in default location:
    • Ensure Chrome is installed at its default path (e.g., C:\Program Files\Google\Chrome\Application\chrome.exe).
    • If using a custom path, specify it in Katalon’s Project Settings:

groovy

ChromeOptions options = new ChromeOptions()  
options.setBinary("C:\\Custom\\Path\\chrome.exe")
  • Permission issues:
    • Run Katalon Studio as administrator.
    • Ensure the ChromeDriver executable has read/write permissions.
  • Antivirus/firewall blocking ChromeDriver:
    • Temporarily disable antivirus/firewall to test.

4. Update Katalon Studio

Older Katalon versions (e.g., 10.2.1) may have compatibility issues with newer browsers.

5. Logs and Debugging

  • Enable verbose logging:
    • In Katalon, go to Project Settings > Execution > Default Executors > Log level: Set to TRACE.
  • Check the Console tab in Katalon for detailed errors.

6. Java Version Compatibility

Katalon Studio 10.x requires Java 8–17. Verify your Java version:

bash

java -version

If using Java 17, ensure it’s compatible with your Katalon version.

Example Fix

Replace your browser-opening code with this generic workaround:

groovy

ChromeOptions options = new ChromeOptions()  
options.addArguments("--no-sandbox")  
options.addArguments("--disable-dev-shm-usage")  
options.addArguments("--remote-allow-origins=*")  

WebUI.openBrowser('')  
DriverFactory.changeWebDriver(DriverFactory.getWebDriver())  
WebUI.navigateToUrl('https://your-site.com')

If All Else Fails

  • Try testing with Firefox (GeckoDriver) to isolate the issue.
3

Hey Dineshh,

I am still facing following issue:

image
image673×295 11.3 KB

4

Hi @shraddha.borkar,

Thank you for sharing your issue. Which KS version are you using? If not the latest, please help upgrade it. Otherwise, I found a similar article to workaround this here: https://katalon-inc.my.site.com/support/article/Troubleshoot-BrowserNotOpenedException-Browser-is-not-opened-in-Katalon-v9-0-0. Please take a look and let us know if it works/not work

5

Can you confirm your katalon current version and upgrade to latest version

6

I have upgraded to 10.2.2 and issue is resolved in this.

Thanks!!

3 Likes