Merge branch 'trunk' into renovate/gradle-8.x

harsha509 · web-flow · commit 0a92fa8cc5a7 · 2025-01-15T11:09:24.000+05:30
diff --git a/examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java b/examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java
@@ -0,0 +1,24 @@
+package dev.selenium.selenium_manager;
+
+import org.junit.jupiter.api.Test;
+import org.openqa.selenium.WebDriver;
+import org.openqa.selenium.chrome.ChromeDriver;
+
+public class SeleniumManagerUsageDemo {
+
+    @Test
+    public void testSetupWithoutManager() {
+        System.setProperty("webdriver.chrome.driver", "/path/to/chromedriver");
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/documentation/selenium_manager/");
+        driver.quit();
+    }
+
+    @Test
+    public void testSetupWithManager() {
+        WebDriver driver = new ChromeDriver();
+        driver.get("https://www.selenium.dev/documentation/selenium_manager/");
+        driver.quit();
+    }
+    
+}
diff --git a/examples/kotlin/pom.xml b/examples/kotlin/pom.xml
@@ -12,7 +12,7 @@
         <kotlin.version>2.0.21</kotlin.version>
 
         <slf4j.version>2.0.16</slf4j.version>
-        <logback.version>1.5.14</logback.version>
+        <logback.version>1.5.16</logback.version>
 
         <junit5.version>5.11.4</junit5.version>
         <wdm.version>5.2.3</wdm.version>
diff --git a/examples/python/tests/browsers/test_safari.py b/examples/python/tests/browsers/test_safari.py
@@ -14,7 +14,7 @@ def test_basic_options():
 
 @pytest.mark.skipif(sys.platform != "darwin", reason="requires Mac")
 def test_enable_logging():
-    service = webdriver.SafariService(service_args=["--diagnose"])
+    service = webdriver.SafariService(enable_logging=True)
 
     driver = webdriver.Safari(service=service)
 
diff --git a/examples/python/tests/interactions/test_print_options.py b/examples/python/tests/interactions/test_print_options.py
@@ -23,8 +23,8 @@ def test_range(driver):
 def test_size(driver):
     driver.get("https://www.selenium.dev/")
     print_options = PrintOptions()
-    print_options.scale = 0.5 ## 0.1 to 2.0``
-    assert print_options.scale == 0.5
+    print_options.page_height = 27.94  # Use page_width to assign width
+    assert print_options.page_height == 27.94
 
 def test_margin(driver):
     driver.get("https://www.selenium.dev/")
diff --git a/examples/ruby/Gemfile.lock b/examples/ruby/Gemfile.lock
@@ -4,7 +4,7 @@ GEM
     ast (2.4.2)
     base64 (0.2.0)
     diff-lcs (1.5.1)
-    json (2.9.0)
+    json (2.9.1)
     language_server-protocol (3.17.0.3)
     logger (1.6.1)
     parallel (1.26.3)
@@ -14,7 +14,7 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.2.1)
-    regexp_parser (2.9.3)
+    regexp_parser (2.10.0)
     rexml (3.3.9)
     rspec (3.13.0)
       rspec-core (~> 3.13.0)
@@ -29,7 +29,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.0)
-    rubocop (1.69.2)
+    rubocop (1.70.0)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
@@ -39,7 +39,7 @@ GEM
       rubocop-ast (>= 1.36.2, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.36.2)
+    rubocop-ast (1.37.0)
       parser (>= 3.3.1.0)
     rubocop-rspec (3.3.0)
       rubocop (~> 1.61)
diff --git a/website_and_docs/content/documentation/selenium_manager.en.md b/website_and_docs/content/documentation/selenium_manager.en.md
@@ -219,8 +219,11 @@ INFO    Browser path: C:\Users\boni\.cache\selenium\chrome\win64\117.0.5938.22\c
 ### Implementing Selenium Manager in Your Scripts
 
 {{< tabpane text=true >}}
-{{< tab header="Java" >}}
-{{< badge-code >}}
+{{% tab header="Java" %}}
+**Previously**
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java#L10-L15" >}}
+**Selenium Manager**
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java#L18-L22" >}}
 {{< /tab >}}
 {{% tab header="Python" %}}
 **Previously**
diff --git a/website_and_docs/content/documentation/selenium_manager.ja.md b/website_and_docs/content/documentation/selenium_manager.ja.md
@@ -219,8 +219,11 @@ INFO    Browser path: C:\Users\boni\.cache\selenium\chrome\win64\117.0.5938.22\c
 ### Implementing Selenium Manager in Your Scripts
 
 {{< tabpane text=true >}}
-{{< tab header="Java" >}}
-{{< badge-code >}}
+{{% tab header="Java" %}}
+**Previously**
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java#L10-L15" >}}
+**Selenium Manager**
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java#L18-L22" >}}
 {{< /tab >}}
 {{% tab header="Python" %}}
 **Previously**
diff --git a/website_and_docs/content/documentation/selenium_manager.pt-br.md b/website_and_docs/content/documentation/selenium_manager.pt-br.md
@@ -219,8 +219,11 @@ INFO    Browser path: C:\Users\boni\.cache\selenium\chrome\win64\117.0.5938.22\c
 ### Implementing Selenium Manager in Your Scripts
 
 {{< tabpane text=true >}}
-{{< tab header="Java" >}}
-{{< badge-code >}}
+{{% tab header="Java" %}}
+**Previously**
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java#L10-L15" >}}
+**Selenium Manager**
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java#L18-L22" >}}
 {{< /tab >}}
 {{% tab header="Python" %}}
 **Previously**
diff --git a/website_and_docs/content/documentation/selenium_manager.zh-cn.md b/website_and_docs/content/documentation/selenium_manager.zh-cn.md
@@ -219,8 +219,11 @@ INFO    Browser path: C:\Users\boni\.cache\selenium\chrome\win64\117.0.5938.22\c
 ### Implementing Selenium Manager in Your Scripts
 
 {{< tabpane text=true >}}
-{{< tab header="Java" >}}
-{{< badge-code >}}
+{{% tab header="Java" %}}
+**Previously**
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java#L10-L15" >}}
+**Selenium Manager**
+{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/selenium_manager/SeleniumManagerUsageDemo.java#L18-L22" >}}
 {{< /tab >}}
 {{% tab header="Python" %}}
 **Previously**
diff --git a/website_and_docs/content/documentation/webdriver/browsers/safari.en.md b/website_and_docs/content/documentation/webdriver/browsers/safari.en.md
@@ -69,6 +69,7 @@ Property key: `SafariDriverService.SAFARI_DRIVER_LOGGING`\
 Property value: `"true"` or `"false"`
 {{% /tab %}}
 {{< tab header="Python" >}}
+{{< badge-version version="4.26" >}}
 {{< gh-codeblock path="examples/python/tests/browsers/test_safari.py#L17" >}}
 {{< /tab >}}
 {{< tab header="CSharp" >}}
diff --git a/website_and_docs/content/documentation/webdriver/browsers/safari.ja.md b/website_and_docs/content/documentation/webdriver/browsers/safari.ja.md
@@ -68,6 +68,7 @@ Property key: `SafariDriverService.SAFARI_DRIVER_LOGGING`\
 Property value: `"true"` or `"false"`
 {{% /tab %}}
 {{< tab header="Python" >}}
+{{< badge-version version="4.26" >}}
 {{< gh-codeblock path="examples/python/tests/browsers/test_safari.py#L17" >}}
 {{< /tab >}}
 {{< tab header="CSharp" >}}
diff --git a/website_and_docs/content/documentation/webdriver/browsers/safari.pt-br.md b/website_and_docs/content/documentation/webdriver/browsers/safari.pt-br.md
@@ -68,6 +68,7 @@ Property key: `SafariDriverService.SAFARI_DRIVER_LOGGING`\
 Property value: `"true"` or `"false"`
 {{% /tab %}}
 {{< tab header="Python" >}}
+{{< badge-version version="4.26" >}}
 {{< gh-codeblock path="examples/python/tests/browsers/test_safari.py#L17" >}}
 {{< /tab >}}
 {{< tab header="CSharp" >}}
diff --git a/website_and_docs/content/documentation/webdriver/browsers/safari.zh-cn.md b/website_and_docs/content/documentation/webdriver/browsers/safari.zh-cn.md
@@ -71,6 +71,7 @@ Safari 浏览器不允许您选择日志的输出位置或更改级别.
 属性值: `"true"` 或 `"false"`
 {{% /tab %}}
 {{< tab header="Python" >}}
+{{< badge-version version="4.26" >}}
 {{< gh-codeblock path="examples/python/tests/browsers/test_safari.py#L17" >}}
 {{< /tab >}}
 {{< tab header="CSharp" >}}
diff --git a/website_and_docs/content/documentation/webdriver/elements/file_upload.zh-cn.md b/website_and_docs/content/documentation/webdriver/elements/file_upload.zh-cn.md
@@ -7,9 +7,9 @@ aliases: [
 ]
 ---
 
-Because Selenium cannot interact with the file upload dialog, it provides a way
-to upload files without opening the dialog. If the element is an `input` element with type `file`, 
-you can use the send keys method to send the full path to the file that will be uploaded.
+由于 Selenium 不能与文件上传对话框交互，因此它提供了一种无需打开对话框即可上传文件的方法。
+如果该元素是一个类型为 `file` 的 `input` 元素，则可以使用
+send keys 方法发送将要上传文件的完整路径。
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}
diff --git a/website_and_docs/content/documentation/webdriver/interactions/print_page.en.md b/website_and_docs/content/documentation/webdriver/interactions/print_page.en.md
@@ -64,7 +64,7 @@ Using the `getPageRanges()` and `setPageRanges()` methods, you can get/set the r
 {{< /tabpane >}}
 
 ### Size
-Using the `getPaperSize()` and `setPaperSize()` methods, you can get/set the paper size to print --- e.g. "A0", "A6", "Legal", "Tabloid", etc.
+Using the `getPageSize()` and `setPageSize()` methods, you can get/set the paper size to print --- e.g. "A0", "A6", "Legal", "Tabloid", etc.
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}
diff --git a/website_and_docs/content/documentation/webdriver/interactions/print_page.ja.md b/website_and_docs/content/documentation/webdriver/interactions/print_page.ja.md
@@ -64,7 +64,7 @@ Using the `getPageRanges()` and `setPageRanges()` methods, you can get/set the r
 {{< /tabpane >}}
 
 ### Size
-Using the `getPaperSize()` and `setPaperSize()` methods, you can get/set the paper size to print --- e.g. "A0", "A6", "Legal", "Tabloid", etc.
+Using the `getPageSize()` and `setPageSize()` methods, you can get/set the paper size to print --- e.g. "A0", "A6", "Legal", "Tabloid", etc.
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}
diff --git a/website_and_docs/content/documentation/webdriver/interactions/print_page.pt-br.md b/website_and_docs/content/documentation/webdriver/interactions/print_page.pt-br.md
@@ -64,7 +64,7 @@ Using the `getPageRanges()` and `setPageRanges()` methods, you can get/set the r
 {{< /tabpane >}}
 
 ### Size
-Using the `getPaperSize()` and `setPaperSize()` methods, you can get/set the paper size to print --- e.g. "A0", "A6", "Legal", "Tabloid", etc.
+Using the `getPageSize()` and `setPageSize()` methods, you can get/set the paper size to print --- e.g. "A0", "A6", "Legal", "Tabloid", etc.
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}
diff --git a/website_and_docs/content/documentation/webdriver/interactions/print_page.zh-cn.md b/website_and_docs/content/documentation/webdriver/interactions/print_page.zh-cn.md
@@ -62,7 +62,7 @@ Selenium 通过其 PrintOptions、PrintsPage 和 browsingContext 类简化了这
 {{< /tabpane >}}
 
 ### 尺寸
-通过 `getPaperSize()` 和 `setPaperSize()` 方法，可以获取/设置要打印页面的纸张尺寸（如"A0"、"A6"、"Legal"、"Tabloid" 等）。
+通过 `getPageSize()` 和 `setPageSize()` 方法，可以获取/设置要打印页面的纸张尺寸（如"A0"、"A6"、"Legal"、"Tabloid" 等）。
 
 {{< tabpane text=true >}}
 {{< tab header="Java" >}}
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
@@ -163,3 +163,19 @@ This exception occurs when the WebDriver is unable to create a new session for t
 - 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).
 
+## ElementNotInteractableException
+
+This exception occurs when Selenium tries to interact with an element that is not interactable in its current state.
+
+### Likely Cause
+
+1. **Unsupported Operation**: Performing an action, like `sendKeys`, on an element that doesn’t support it (e.g., `<form>` or `<label>`).  
+2. **Multiple Elements Matching Locator**: The locator targets a non-interactable element, such as a `<td>` tag, instead of the intended `<input>` field.  
+3. **Hidden Elements**: The element is present in the DOM but not visible on the page due to CSS, the `hidden` attribute, or being outside the visible viewport.
+
+### Possible Solutions
+
+1. Use actions appropriate for the element type (e.g., use `sendKeys` with `<input>` fields only).  
+2. Ensure locators uniquely identify the intended element to avoid incorrect matches.  
+3. Check if the element is visible on the page before interacting with it. Use scrolling to bring the element into view, if required.  
+4. Use explicit waits to ensure the element is interactable before performing actions.
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
@@ -157,4 +157,21 @@ This exception occurs when the WebDriver is unable to create a new session for t
 
 - 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).
+- Verify the driver binary is executable (`chmod +x /path/to/driver` on Linux/macOS).
+
+## ElementNotInteractableException
+
+This exception occurs when Selenium tries to interact with an element that is not interactable in its current state.
+
+### Likely Cause
+
+1. **Unsupported Operation**: Performing an action, like `sendKeys`, on an element that doesn’t support it (e.g., `<form>` or `<label>`).  
+2. **Multiple Elements Matching Locator**: The locator targets a non-interactable element, such as a `<td>` tag, instead of the intended `<input>` field.  
+3. **Hidden Elements**: The element is present in the DOM but not visible on the page due to CSS, the `hidden` attribute, or being outside the visible viewport.
+
+### Possible Solutions
+
+1. Use actions appropriate for the element type (e.g., use `sendKeys` with `<input>` fields only).  
+2. Ensure locators uniquely identify the intended element to avoid incorrect matches.  
+3. Check if the element is visible on the page before interacting with it. Use scrolling to bring the element into view, if required.  
+4. Use explicit waits to ensure the element is interactable before performing actions.
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
@@ -159,3 +159,19 @@ This exception occurs when the WebDriver is unable to create a new session for t
 - 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).
 
+## ElementNotInteractableException
+
+This exception occurs when Selenium tries to interact with an element that is not interactable in its current state.
+
+### Likely Cause
+
+1. **Unsupported Operation**: Performing an action, like `sendKeys`, on an element that doesn’t support it (e.g., `<form>` or `<label>`).  
+2. **Multiple Elements Matching Locator**: The locator targets a non-interactable element, such as a `<td>` tag, instead of the intended `<input>` field.  
+3. **Hidden Elements**: The element is present in the DOM but not visible on the page due to CSS, the `hidden` attribute, or being outside the visible viewport.
+
+### Possible Solutions
+
+1. Use actions appropriate for the element type (e.g., use `sendKeys` with `<input>` fields only).  
+2. Ensure locators uniquely identify the intended element to avoid incorrect matches.  
+3. Check if the element is visible on the page before interacting with it. Use scrolling to bring the element into view, if required.  
+4. Use explicit waits to ensure the element is interactable before performing actions.
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
@@ -161,3 +161,20 @@ Actions class with `Actions.moveToElement(element)`.
 - 确保 WebDriver 版本与浏览器版本匹配。对于 Chrome，请在浏览器中访问 `chrome://settings/help` 检查浏览器版本，并从 [ChromeDriver 下载](https://chromedriver.chromium.org/downloads)页面下载匹配的驱动程序。
 - 在 macOS 上，转到 **系统设置 > 隐私与安全性**，并允许驱动程序运行（如果被阻止）。
 - 验证驱动程序二进制文件是否可执行（在 Linux/macOS 上运行 `chmod +x /path/to/driver`）。
+
+## ElementNotInteractableException
+
+当 Selenium 尝试与当前状态下无法交互的元素进行交互时，会发生此异常。
+
+### 可能的原因
+
+1. **不支持的操作**：尝试对不支持操作的元素执行操作，例如对 `<form>` 或 `<label>` 使用 `sendKeys`。  
+2. **多个元素匹配定位器**：定位器匹配到非可交互的元素，例如 `<td>` 标签，而不是目标的 `<input>` 字段。  
+3. **隐藏的元素**：元素存在于 DOM 中，但由于 CSS、`hidden` 属性或元素超出可见视口范围而不可见。
+
+### 可能的解决方案
+
+1. 根据元素类型使用适当的操作（例如，仅对 `<input>` 字段使用 `sendKeys`）。  
+2. 确保定位器唯一标识目标元素，以避免错误匹配。  
+3. 在与元素交互之前，检查其是否在页面上可见。如果需要，将元素滚动到视图中。  
+4. 使用显式等待以确保元素在执行操作前可交互。
diff --git a/website_and_docs/content/events/_index.html b/website_and_docs/content/events/_index.html
@@ -45,9 +45,12 @@ <h2 class="card-title">Selenium Meetups</h2>
       <div class="card-body">
         <h2 class="card-title">Selenium Conference</h2>
         <p class="card-text pt-4">
-          The next flagship Selenium conference will be an in-person event held in Chicago, IL on March 28-30, 2023 The SeConf brings
-          together Selenium developers & enthusiasts from around the world to share ideas,
-          socialize, and work together on advancing the present and future success of the project.
+          The next flagship Selenium conference will be held together
+          with Appium conference. It will be an in-person event
+          held in Valencia, Spain on March 26-28, 2025. The Selenium Conference
+          and Appium Conference brings together Selenium and Appium developers & enthusiasts
+          from around the world to share ideas, socialize, and work together on
+          advancing the present and future success of the project.
         </p>
       </div>
       <div class="card-footer bg-transparent border-0">
diff --git a/website_and_docs/hugo.toml b/website_and_docs/hugo.toml
@@ -206,16 +206,40 @@ enable = false
 
 [params.links]
 # End user relevant links. These will show up on left side of footer and in the community page if you have one.
+[[params.links.user]]
+	name = "Selenium Linkedin"
+	url = "https://www.linkedin.com/company/4826427/"
+	icon = "fab fa-linkedin-in"
+        desc = "Check all the Community talks!"
+# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
+[[params.links.user]]
+	name ="Selenium X"
+	url = "https://x.com/SeleniumHQ"
+	icon = "fab fa-twitter"
+        desc = "Follow us on X to get the latest news!"
+[[params.links.user]]
+	name = "Selenium Community YouTube Channel"
+	url = "https://www.youtube.com/@SeleniumHQProject/streams"
+	icon = "fab fa-youtube"
+        desc = "Check all the Community talks!"
+# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
+[[params.links.user]]
+	name = "Selenium Mastodon"
+	url = "https://mastodon.social/@seleniumHQ@fosstodon.org"
+	icon = "fab fa-mastodon"
+        desc = "Selenium mastodon!"
+# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
+[[params.links.user]]
+	name = "Selenium BlueSky"
+	url = "https://bsky.app/profile/seleniumconf.bsky.social"
+	icon = "fab fa-bluesky"
+        desc = "Selenium BlueSky!"
+# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
 [[params.links.user]]
 	name = "User mailing list"
 	url = "https://groups.google.com/group/selenium-users"
 	icon = "fas fa-mail-bulk"
         desc = "Discussion and help from your fellow users"
-[[params.links.user]]
-	name ="Selenium in Twitter"
-	url = "https://twitter.com/SeleniumHQ"
-	icon = "fab fa-twitter"
-        desc = "Follow us on Twitter to get the latest news!"
 [[params.links.user]]
 	name = "SeleniumConf YouTube Channel"
 	url = "https://www.youtube.com/channel/UCbDlgX_613xNMrDqCe3QNEw"
diff --git a/website_and_docs/layouts/partials/announcement-banner.html b/website_and_docs/layouts/partials/announcement-banner.html
@@ -9,6 +9,10 @@ <h4 class="alert-heading text-center m-2">
               Registrations Open for SeleniumConf 2025 | March 26–28 | Join Us In-Person!
               <a href="https://seleniumconf.com/?utm_medium=Referral&utm_source=selenium.dev&utm_campaign=register" target='_blank' aria-pressed="true"> Register now!</a>
           </h4>
+          <h4 class="alert-heading text-center m-4">
+              Join us for Selenium Community Live Episode 2 on Jan 21st, 2025 -
+              <a href="https://www.linkedin.com/events/seleniumcommunitylive-episode27278315412075769856/" target='_blank' aria-pressed="true"> More information here</a>
+          </h4>
       </div>
     </div>
   </div>
diff --git a/website_and_docs/package-lock.json b/website_and_docs/package-lock.json
diff --git a/website_and_docs/package.json b/website_and_docs/package.json
