Merge branch 'trunk' into renovate/rubocop-1.x-lockfile

Author: harsha509

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" >}}

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.

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.

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.

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. 使用显式等待以确保元素在执行操作前可交互。

website_and_docs/package-lock.json

@@ -10,7 +10,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "autoprefixer": "^10.4.20",
-    "postcss": "^8.4.49",
+    "postcss": "^8.5.0",
     "postcss-cli": "^11.0.0"
   }
 }