[🐛 Bug]: Missing support for RelativeBy in annotations

[gryznar]

What happened?

Despite the code will handle that properly, annotations are unadjusted to RelativeBy. First of all: find_element() and find_elements():

None of them has annotation for by. In both cases, it should be: Union[ByType, RelativeBy]:

Another case are conditions in expected_conditions.py:

Here annotations for locator are: Tuple[str, str], whereas it should be: Union[Tuple[ByType, str], Tuple[RelativeBy, None]]. Same applies for other conditions.

How can we reproduce the issue?

n/a

Relevant log output

n/a

Operating System

n/a

Selenium version

4.24.0 for Python

What are the browser(s) and version(s) where you see this issue?

n/a

What are the browser driver(s) and version(s) where you see this issue?

n/a

Are you using Selenium Grid?

n/a

[github-actions]

@gryznar, thank you for creating this issue. We will troubleshoot it as soon as we can.

---

Info for maintainers

Triage this issue by using labels.

If information is missing, add a helpful comment and then I-issue-template label.

If the issue is a question, add the I-question label.

If the issue is valid but there is no time to troubleshoot it, consider adding the help wanted label.

If the issue requires changes or fixes from an external project (e.g., ChromeDriver, GeckoDriver, MSEdgeDriver, W3C), add the applicable G-* label, and it will provide the correct link and auto-close the issue.

After troubleshooting the issue, please add the R-awaiting answer label.

Thank you!