Improving likely clauses for InvalidSelectorException

diemol · diemol · commit d82c9e887dbd · 2025-08-16T21:16:58.000+02:00
Closes SeleniumHQ#1895 [deploy site]
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
@@ -18,7 +18,9 @@ CSS and XPath Selectors are sometimes difficult to get correct.
 
 ### Likely Cause
 
-The CSS or XPath selector you are trying to use has invalid characters or an invalid query.
+* The CSS or XPath selector you are trying to use has invalid characters or an invalid query.
+* You may have placed an XPATH value as a parameter to a CSS selector, or vice versa.
+* You may have used a CSS or XPATH selector as a parameter to an ID selector.
 
 ### Possible Solutions
 
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
@@ -12,7 +12,9 @@ CSS and XPath Selectors are sometimes difficult to get correct.
 
 ### Likely Cause
 
-The CSS or XPath selector you are trying to use has invalid characters or an invalid query.
+* The CSS or XPath selector you are trying to use has invalid characters or an invalid query.
+* You may have placed an XPATH value as a parameter to a CSS selector, or vice versa.
+* You may have used a CSS or XPATH selector as a parameter to an ID selector.
 
 ### Possible Solutions
 
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
@@ -12,7 +12,9 @@ CSS and XPath Selectors are sometimes difficult to get correct.
 
 ### Likely Cause
 
-The CSS or XPath selector you are trying to use has invalid characters or an invalid query.
+* The CSS or XPath selector you are trying to use has invalid characters or an invalid query.
+* You may have placed an XPATH value as a parameter to a CSS selector, or vice versa.
+* You may have used a CSS or XPATH selector as a parameter to an ID selector.
 
 ### Possible Solutions
 
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
@@ -12,7 +12,9 @@ description: >
 
 ### 潜在原因
 
-您尝试使用的CSS或XPath选择器包含无效字符或无效查询。
+* The CSS or XPath selector you are trying to use has invalid characters or an invalid query.
+* You may have placed an XPATH value as a parameter to a CSS selector, or vice versa.
+* You may have used a CSS or XPATH selector as a parameter to an ID selector.
 
 ### 可行方案
 
