[py] add execute_cdp_cmd to Remote

[Delta456]

User description

Thanks for contributing to Selenium!
A PR well described will help maintainers to quickly review and merge it

Before submitting your PR, please check our contributing guidelines.
Avoid large PRs, help reviewers by making them as simple and short as possible.

Description

Implements execute_cdp_cmd for Remote WebDriver

Motivation and Context

Implements #14799 as it should be accessible via Remote driver as well since Grid provides the endpoints and the underlying command executor

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist

• I have read the contributing document.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.
• All new and existing tests passed.

---

PR Type

Enhancement

---

Description

• Introduced the execute_cdp_cmd method to the Remote WebDriver class, enabling the execution of Chrome DevTools Protocol commands.
• This enhancement allows users to execute specific browser commands directly through the Remote WebDriver, similar to the existing functionality in the Chrome WebDriver.
• The method takes a command name and a dictionary of command arguments, returning the result of the command execution.

---

Changes walkthrough 📝

	Relevant files
Enhancement	webdriver.py Add `execute_cdp_cmd` method to Remote WebDriver                  py/selenium/webdriver/remote/webdriver.py Added execute_cdp_cmd method to the Remote WebDriver class. The method allows execution of Chrome DevTools Protocol commands. Provides a way to pass command name and arguments. Returns the result of the command execution. +20/-0

---

💡 PR-Agent usage: Comment /help "your question" on any pull request to receive relevant information

[qodo-merge-pro]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

🎫 Ticket compliance analysis ✅ 14799 - Fully compliant Compliant requirements: Added execute_cdp_cmd method to Remote WebDriver Method uses execute("executeCdpCommand") internally Implementation matches Chrome WebDriver's functionality

⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪

🧪 No relevant tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Error Handling The execute_cdp_cmd method should include error handling for invalid commands or parameters

[qodo-merge-pro]

PR Code Suggestions ✨

Explore these optional code suggestions:

Category	Suggestion	Score
Possible issue	Add input validation to prevent runtime errors from invalid arguments Add error handling to validate that cmd is a non-empty string and cmd_args is a dictionary before execution, to prevent runtime errors. py/selenium/webdriver/remote/webdriver.py [364-382] def execute_cdp_cmd(self, cmd: str, cmd_args: dict): + if not cmd or not isinstance(cmd, str): + raise ValueError("Command must be a non-empty string") + if not isinstance(cmd_args, dict): + raise ValueError("Command arguments must be a dictionary") return self.execute("executeCdpCommand", {"cmd": cmd, "params": cmd_args})["value"] Apply this suggestion Suggestion importance[1-10]: 8 Why: The suggestion adds crucial input validation to prevent potential runtime errors and provides clear error messages, which is especially important for a public API method that interfaces with Chrome DevTools Protocol.	8

💡 Need additional feedback ? start a PR chat

[VietND96]

Do you think we should add a test for it?

[Delta456]

I don't see any tests of execute_cdp_cmd for ChromiumRemoteConnection. I don't know how will this be tested too.

[VietND96]

@p0deje, do you think this is fine to merge?

[p0deje]

@VietND96 Doesn't this create a duplication as we already have the same method in ChromiumDriver? I am not sure how to re-use it, but maybe we can at least remove it from ChromiumDriver.

[Delta456]

Let's add a deprecation warning before removing it?

[VietND96]

@Delta456, I saw class ChromiumDriver(RemoteWebDriver):, do you think can make Chromium can access and reuse the same method from Remote?

[Delta456]

I will try

[Delta456]

@Delta456, I saw class ChromiumDriver(RemoteWebDriver):, do you think can make Chromium can access and reuse the same method from Remote?

Yes, we can use the same method from Remote. I think we can merge this for now.

We can think of a deprecation warning afterwards.

[VietND96]

Thank you, @Delta456 !