Skip to content

Commit 51b95e6

Browse files
committed
Add documentation for SessionNotCreatedException in troubleshooting errors
1 parent ef7d1c6 commit 51b95e6

File tree

1 file changed

+18
-0
lines changed
  • website_and_docs/content/documentation/webdriver/troubleshooting/errors

1 file changed

+18
-0
lines changed

website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.en.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -145,3 +145,21 @@ like when the last tab/browser has closed (e.g. `driver.close()`)
145145

146146
Check your script for instances of `driver.close()` and `driver.quit()`, and any other possible causes
147147
of closed tabs/browsers. It could be that you are locating an element before you should/can.
148+
149+
## SessionNotCreatedException
150+
151+
This exception occurs when the WebDriver is unable to create a new session for the browser. This often happens due to version mismatches, system-level restrictions, or configuration issues.
152+
153+
### Likely Cause
154+
155+
- The browser version and WebDriver version are incompatible (e.g., ChromeDriver v113 with Chrome v115).
156+
- macOS privacy settings may block the WebDriver from running.
157+
- The WebDriver binary is missing, inaccessible, or lacks the necessary execution permissions (e.g., on Linux/macOS, the driver file may not be executable).
158+
159+
160+
### Possible Solutions
161+
162+
- Ensure the WebDriver version matches the browser version. For Chrome, check the browser version at `chrome://settings/help` and download the matching driver from [ChromeDriver Downloads](https://chromedriver.chromium.org/downloads).
163+
- On macOS, go to **System Settings > Privacy & Security**, and allow the driver to run if blocked.
164+
- Verify the driver binary is executable (`chmod +x /path/to/driver` on Linux/macOS).
165+

0 commit comments

Comments
 (0)