Merge branch 'trunk' into elementNotVisibleException

Author: shbenzer

LICENSE

@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2024 Software Freedom Conservancy (SFC)
+   Copyright 2025 Software Freedom Conservancy (SFC)
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

examples/java/src/test/java/dev/selenium/interactions/PrintOptionsTest.java

@@ -3,7 +3,7 @@
 import org.junit.jupiter.api.Test;
 import org.openqa.selenium.print.PageMargin;
 import org.openqa.selenium.print.PrintOptions;
-
+import org.openqa.selenium.print.PageSize;
 import dev.selenium.BaseChromeTest;
 
 public class PrintOptionsTest extends BaseChromeTest {
@@ -31,8 +31,8 @@ public void TestSize()
     {
         driver.get("https://www.selenium.dev/");
         PrintOptions printOptions = new PrintOptions();
-        printOptions.setScale(.50);
-        double current_scale = printOptions.getScale();
+        printOptions.setPageSize(new PageSize(27.94, 21.59)); // A4 size in cm
+        double currentHeight = printOptions.getPageSize().getHeight(); // use getWidth() to retrieve width
     }
 
     @Test

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

@@ -146,6 +146,23 @@ 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).
+
 ## ElementNotVisibleException
 
 This exception is thrown when the element you are trying to interact with _is_ present in the DOM, but is not visible. 
@@ -160,4 +177,4 @@ This can occur in several situations:
 
 This issue cannot always be resolved on the user's end, however when it can it is usually solved by the following: 
 using an explicit wait, or interacting with the page in such a way to make the element visible 
-(scrolling, clicking a button, etc.)
+(scrolling, clicking a button, etc.)

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

@@ -142,6 +142,23 @@ 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).
+
 ## ElementNotVisibleException
 
 This exception is thrown when the element you are trying to interact with _is_ present in the DOM, but is not visible. 
@@ -156,4 +173,4 @@ This can occur in several situations:
 
 This issue cannot always be resolved on the user's end, however when it can it is usually solved by the following: 
 using an explicit wait, or interacting with the page in such a way to make the element visible 
-(scrolling, clicking a button, etc.)
+(scrolling, clicking a button, etc.)

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

@@ -142,6 +142,23 @@ This usually occurs when the session has been deleted (e.g. `driver.quit()`) or
 
 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).
+
 ## ElementNotVisibleException
 
 This exception is thrown when the element you are trying to interact with _is_ present in the DOM, but is not visible. 
@@ -156,4 +173,4 @@ This can occur in several situations:
 
 This issue cannot always be resolved on the user's end, however when it can it is usually solved by the following: 
 using an explicit wait, or interacting with the page in such a way to make the element visible 
-(scrolling, clicking a button, etc.)
+(scrolling, clicking a button, etc.)

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

@@ -146,6 +146,22 @@ 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`）。
+
 ## ElementNotVisibleException
 
 This exception is thrown when the element you are trying to interact with _is_ present in the DOM, but is not visible. 
@@ -160,4 +176,4 @@ This can occur in several situations:
 
 This issue cannot always be resolved on the user's end, however when it can it is usually solved by the following: 
 using an explicit wait, or interacting with the page in such a way to make the element visible 
-(scrolling, clicking a button, etc.)
+(scrolling, clicking a button, etc.)