Hi everyone,
I’ve been using Katalon Studio (v9.7.5 Build 223) and previously was able to launch Google Chrome with my personal user profile by configuring the following settings under:
`Project > Settings > Desired Capabilities > Web UI > Chrome
Error when I try to run test case:
1 Like
To resolve the Chrome user profile issue in Katalon Studio 9.7.5, follow these steps:
1. Update Desired Capabilities Syntax
Modern Selenium versions require goog:chromeOptions
instead of chromeOptions
:
{
"goog:chromeOptions": {
"args": [
"user-data-dir=C:/Users/YourUsername/AppData/Local/Google/Chrome/User Data",
"profile-directory=Profile 1" // Omit if using "Default" profile
]
}
}
- Note: Replace
YourUsername
and ensure the path uses forward slashes or escaped backslashes (C:\\Users\\...
).
2. Verify Profile Directory Accessibility
- Close all Chrome processes before running tests (prevents profile lock).
- Check permissions: Ensure Katalon has read/write access to the profile folder.
3. Avoid Default Profile Conflicts
Use a dedicated profile for automation (not Default
):
"args": [
"user-data-dir=C:/Katalon_Chrome_Profile",
"profile-directory=KatalonProfile"
]
- Manually create the folder
C:/Katalon_Chrome_Profile
and launch Chrome once to initialize it.
4. Disable Chrome Sandbox (If Needed)
Add these arguments for environments with strict security:
"args": [
...,
"--no-sandbox",
"--disable-dev-shm-usage"
]
5. Use Katalon’s Built-In Profile Handling
Instead of manual setup, leverage Katalon’s Chrome Preferences:
- Go to Project > Settings > Execution > Default > WebUI > Chrome.
- Check Reuse existing Chrome profile and specify the directory.
6. Confirm ChromeDriver Compatibility
- Ensure the ChromeDriver version matches your Chrome browser (check via
chrome://version
).
- Update ChromeDriver in Katalon via Tools > Update WebDrivers.
7. Debugging Steps
- Check logs: Review
console logs
for errors like invalid profile path
or permission denied
.
- Minimal test case: Run a script that only opens Chrome with the profile:
WebUI.openBrowser('')
WebUI.navigateToUrl('chrome://version/') // Verify profile path
WebUI.closeBrowser()
8. Alternative: Load Profile via Relative Path
For portability, use a profile within the project:
"args": [
"user-data-dir=${System.getProperty('user.dir')}/ChromeProfile"
]
If the issue persists, share the exact error message from logs and validate the profile setup using a standalone Selenium script outside Katalon to isolate the cause