Skip to content

Commit 18b7f8d

Browse files
yvsvarmaharsha509
andauthored
Add documentation for SessionNotCreatedException in troubleshooting errors (SeleniumHQ#2119)[deploy site]
* Add documentation for SessionNotCreatedException in troubleshooting errors * Add SessionNotCreatedException to Chinese translation (_index.zh-cn.md) * Add SessionNotCreatedException to Portuguese translation (_index.pt-br.md) --------- Co-authored-by: Sri Harsha <[email protected]>
1 parent 22f0293 commit 18b7f8d

File tree

4 files changed

+69
-0
lines changed

4 files changed

+69
-0
lines changed

Diff for: website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.en.md

+18
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+

Diff for: website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.ja.md

+17
Original file line numberDiff line numberDiff line change
@@ -141,3 +141,20 @@ like when the last tab/browser has closed (e.g. `driver.close()`)
141141

142142
Check your script for instances of `driver.close()` and `driver.quit()`, and any other possible causes of closed
143143
tabs/browsers. It could be that you are locating an element before you should/can.
144+
145+
## SessionNotCreatedException
146+
147+
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.
148+
149+
### Likely Cause
150+
151+
- The browser version and WebDriver version are incompatible (e.g., ChromeDriver v113 with Chrome v115).
152+
- macOS privacy settings may block the WebDriver from running.
153+
- The WebDriver binary is missing, inaccessible, or lacks the necessary execution permissions (e.g., on Linux/macOS, the driver file may not be executable).
154+
155+
156+
### Possible Solutions
157+
158+
- 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).
159+
- On macOS, go to **System Settings > Privacy & Security**, and allow the driver to run if blocked.
160+
- Verify the driver binary is executable (`chmod +x /path/to/driver` on Linux/macOS).

Diff for: website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.pt-br.md

+18
Original file line numberDiff line numberDiff line change
@@ -141,3 +141,21 @@ This usually occurs when the session has been deleted (e.g. `driver.quit()`) or
141141
### Possible Solutions
142142

143143
Check your script for instances of `driver.close()` and `driver.quit()`, and any other possible causes of closed tabs/browsers. It could be that you are locating an element before you should/can.
144+
145+
## SessionNotCreatedException
146+
147+
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.
148+
149+
### Likely Cause
150+
151+
- The browser version and WebDriver version are incompatible (e.g., ChromeDriver v113 with Chrome v115).
152+
- macOS privacy settings may block the WebDriver from running.
153+
- The WebDriver binary is missing, inaccessible, or lacks the necessary execution permissions (e.g., on Linux/macOS, the driver file may not be executable).
154+
155+
156+
### Possible Solutions
157+
158+
- 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).
159+
- On macOS, go to **System Settings > Privacy & Security**, and allow the driver to run if blocked.
160+
- Verify the driver binary is executable (`chmod +x /path/to/driver` on Linux/macOS).
161+

Diff for: website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.zh-cn.md

+16
Original file line numberDiff line numberDiff line change
@@ -145,3 +145,19 @@ Actions class with `Actions.moveToElement(element)`.
145145

146146
### 可能的解决方案
147147
检查脚本中是否有 `driver.close()``driver.quit()` 的实例,以及其他可能导致标签页/浏览器关闭的原因。可能是您在应该/能够定位元素之前就尝试定位了该元素。
148+
149+
## SessionNotCreatedException
150+
151+
此异常发生在 WebDriver 无法为浏览器创建新会话时。通常由于版本不匹配、系统级限制或配置问题导致。
152+
153+
### 可能的原因
154+
155+
- 浏览器版本和 WebDriver 版本不兼容(例如 ChromeDriver v113 和 Chrome v115)。
156+
- macOS 隐私设置可能会阻止 WebDriver 运行。
157+
- WebDriver 二进制文件丢失、不可访问或没有执行权限。
158+
159+
### 可能的解决方案
160+
161+
- 确保 WebDriver 版本与浏览器版本匹配。对于 Chrome,请在浏览器中访问 `chrome://settings/help` 检查浏览器版本,并从 [ChromeDriver 下载](https://chromedriver.chromium.org/downloads)页面下载匹配的驱动程序。
162+
- 在 macOS 上,转到 **系统设置 > 隐私与安全性**,并允许驱动程序运行(如果被阻止)。
163+
- 验证驱动程序二进制文件是否可执行(在 Linux/macOS 上运行 `chmod +x /path/to/driver`)。

0 commit comments

Comments
 (0)