Add documentation for SessionNotCreatedException in troubleshooting e…

…rrors (#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]>
SeleniumHQ · Jan 3, 2025 · 18b7f8d · 18b7f8d
1 parent 22f0293
commit 18b7f8d
Show file tree

Hide file tree

Showing 4 changed files with 69 additions and 0 deletions.
diff --git a/...te_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.en.md b/...te_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.en.md
@@ -145,3 +145,21 @@ like when the last tab/browser has closed (e.g. `driver.close()`)
 
 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.
+
+## SessionNotCreatedException
+
+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.
+
+### Likely Cause
+
+- The browser version and WebDriver version are incompatible (e.g., ChromeDriver v113 with Chrome v115).
+- macOS privacy settings may block the WebDriver from running.
+- The WebDriver binary is missing, inaccessible, or lacks the necessary execution permissions (e.g., on Linux/macOS, the driver file may not be executable).
+
+
+### Possible Solutions
+
+- 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).
+- On macOS, go to **System Settings > Privacy & Security**, and allow the driver to run if blocked.
+- Verify the driver binary is executable (`chmod +x /path/to/driver` on Linux/macOS).
+
diff --git a/...te_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.ja.md b/...te_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.ja.md
@@ -141,3 +141,20 @@ like when the last tab/browser has closed (e.g. `driver.close()`)
 
 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.
+
+## SessionNotCreatedException
+
+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.
+
+### Likely Cause
+
+- The browser version and WebDriver version are incompatible (e.g., ChromeDriver v113 with Chrome v115).
+- macOS privacy settings may block the WebDriver from running.
+- The WebDriver binary is missing, inaccessible, or lacks the necessary execution permissions (e.g., on Linux/macOS, the driver file may not be executable).
+
+
+### Possible Solutions
+
+- 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).
+- On macOS, go to **System Settings > Privacy & Security**, and allow the driver to run if blocked.
+- Verify the driver binary is executable (`chmod +x /path/to/driver` on Linux/macOS).
diff --git a/...and_docs/content/documentation/webdriver/troubleshooting/errors/_index.pt-br.md b/...and_docs/content/documentation/webdriver/troubleshooting/errors/_index.pt-br.md
@@ -141,3 +141,21 @@ This usually occurs when the session has been deleted (e.g. `driver.quit()`) or
 ### Possible Solutions
 
 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.
+
+## SessionNotCreatedException
+
+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.
+
+### Likely Cause
+
+- The browser version and WebDriver version are incompatible (e.g., ChromeDriver v113 with Chrome v115).
+- macOS privacy settings may block the WebDriver from running.
+- The WebDriver binary is missing, inaccessible, or lacks the necessary execution permissions (e.g., on Linux/macOS, the driver file may not be executable).
+
+
+### Possible Solutions
+
+- 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).
+- On macOS, go to **System Settings > Privacy & Security**, and allow the driver to run if blocked.
+- Verify the driver binary is executable (`chmod +x /path/to/driver` on Linux/macOS).
+
diff --git a/...and_docs/content/documentation/webdriver/troubleshooting/errors/_index.zh-cn.md b/...and_docs/content/documentation/webdriver/troubleshooting/errors/_index.zh-cn.md
@@ -145,3 +145,19 @@ Actions class with `Actions.moveToElement(element)`.
 
 ### 可能的解决方案
 检查脚本中是否有 `driver.close()` 和 `driver.quit()` 的实例，以及其他可能导致标签页/浏览器关闭的原因。可能是您在应该/能够定位元素之前就尝试定位了该元素。
+
+## SessionNotCreatedException
+
+此异常发生在 WebDriver 无法为浏览器创建新会话时。通常由于版本不匹配、系统级限制或配置问题导致。
+
+### 可能的原因
+
+- 浏览器版本和 WebDriver 版本不兼容（例如 ChromeDriver v113 和 Chrome v115）。
+- macOS 隐私设置可能会阻止 WebDriver 运行。
+- WebDriver 二进制文件丢失、不可访问或没有执行权限。
+
+### 可能的解决方案
+
+- 确保 WebDriver 版本与浏览器版本匹配。对于 Chrome，请在浏览器中访问 `chrome://settings/help` 检查浏览器版本，并从 [ChromeDriver 下载](https://chromedriver.chromium.org/downloads)页面下载匹配的驱动程序。
+- 在 macOS 上，转到 **系统设置 > 隐私与安全性**，并允许驱动程序运行（如果被阻止）。
+- 验证驱动程序二进制文件是否可执行（在 Linux/macOS 上运行 `chmod +x /path/to/driver`）。