[py] Type event firing script execution results

[adamtheturtle]

Summary

Add explicit Any return annotations to EventFiringWebDriver.execute_script and execute_async_script.

Details

The wrapped WebDriver methods return arbitrary JavaScript result values, not only dictionaries. The base WebDriver methods are already annotated as returning Any; this updates the event-firing wrapper to match that public API and avoid untyped wrapper methods.

Validation

• uv run --with ruff ruff check --config py/pyproject.toml py/selenium/webdriver/support/event_firing_webdriver.py
• python3 -m compileall -q py/selenium/webdriver/support/event_firing_webdriver.py

[selenium-ci]

Thank you, @adamtheturtle for this code suggestion.

The support packages contain example code that many users find helpful, but they do not necessarily represent
the best practices for using Selenium, and the Selenium team is not currently merging changes to them.

After reviewing the change, unless it is a critical fix or a feature that is needed for Selenium
to work, we will likely close the PR.

We actively encourage people to add the wrapper and helper code that makes sense for them to their own frameworks.
If you have any questions, please contact us

[qodo-code-review]

Review Summary by Qodo

Add return type annotations to event firing script methods

✨ Enhancement

Walkthroughs

Description

• Add explicit Any return type annotations to script execution methods
• Align EventFiringWebDriver type hints with base WebDriver API
• Add missing type hint for script parameter in execute_async_script

Diagram

flowchart LR
  A["EventFiringWebDriver methods"] -- "Add Any return type" --> B["execute_script"]
  A -- "Add Any return type + script type hint" --> C["execute_async_script"]
  B -- "Match base WebDriver API" --> D["Type consistency"]
  C -- "Match base WebDriver API" --> D

Loading

File Changes

1. py/selenium/webdriver/support/event_firing_webdriver.py ✨ Enhancement +2/-2

Add return type annotations to script execution methods

• Add -> Any return type annotation to execute_script method
• Add -> Any return type annotation to execute_async_script method
• Add missing script: str type hint parameter to execute_async_script
• Align wrapper method signatures with base WebDriver public API

py/selenium/webdriver/support/event_firing_webdriver.py

---

[qodo-code-review]

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Great, no issues found!

Qodo reviewed your code and found no material issues that require review