[🚀 Feature]: Allow specifying a callable for the message argument in WebDriverWait.until / until_not.

[moeyashi]

Feature and motivation

I would like to construct an error message using the driver in the message argument of WebDriverWait.until / until_not when an error occurs.

Currently, it is necessary to use a try-catch structure, but if the message argument could accept a function, I believe it would allow for more readable code.

Usage example

WebDriverWait(driver, 10).until(lambda x: x.find_element(By.ID, "someId"), lambda x: f'Message: {x.current_url}')

[github-actions]

@moeyashi, 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!

[github-actions]

This issue is stale because it has been open 280 days with no activity. Remove stale label or comment or this will be closed in 14 days.

[selenium-ci]

This issue is looking for contributors.

Please comment below or reach out to us through our IRC/Slack/Matrix channels if you are interested.

[titusfortner]

Could just be this, right?

                final_message = message() if callable(message) else message

[Delta456]

Won't this be a breaking considering the default value of message is empty string?

until(self, method: Callable[[D], Union[Literal[False], T]], message: str = "")

[titusfortner]

Default shouldn't need to change. Dynamic typing means you can pass in either type and then the code can check which it is and handle appropriately.