From 51b95e67c7b590f8edd313d536017b2d636a7cde Mon Sep 17 00:00:00 2001 From: yvsvarma Date: Thu, 2 Jan 2025 01:45:42 -0600 Subject: [PATCH 1/3] Add documentation for SessionNotCreatedException in troubleshooting errors --- .../troubleshooting/errors/_index.en.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.en.md b/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.en.md index 409475e12c8a..38ba7a0a5f2a 100644 --- a/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.en.md +++ b/website_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). + From e31d0c5216882bc7ec8ccd4e17fb93f7b0f0ff94 Mon Sep 17 00:00:00 2001 From: yvsvarma Date: Thu, 2 Jan 2025 22:30:02 -0600 Subject: [PATCH 2/3] Add SessionNotCreatedException to Chinese translation (_index.zh-cn.md) --- .../troubleshooting/errors/_index.zh-cn.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.zh-cn.md b/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.zh-cn.md index fe8e5d9162aa..e9b0d4372e06 100644 --- a/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.zh-cn.md +++ b/website_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`)。 From 9ffc3a8d6861d81425dab87af55a30096cac9ce1 Mon Sep 17 00:00:00 2001 From: yvsvarma Date: Thu, 2 Jan 2025 22:36:24 -0600 Subject: [PATCH 3/3] Add SessionNotCreatedException to Portuguese translation (_index.pt-br.md) --- .../troubleshooting/errors/_index.ja.md | 17 +++++++++++++++++ .../troubleshooting/errors/_index.pt-br.md | 18 ++++++++++++++++++ 2 files changed, 35 insertions(+) diff --git a/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.ja.md b/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.ja.md index 2241ec21470f..87c1c869e179 100644 --- a/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.ja.md +++ b/website_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). \ No newline at end of file diff --git a/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.pt-br.md b/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.pt-br.md index 70f7d40a4811..6930ccfd5a70 100644 --- a/website_and_docs/content/documentation/webdriver/troubleshooting/errors/_index.pt-br.md +++ b/website_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). +