[java][bidi]: implement bidi setCacheBehavior

[navin772]

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

This PR adds the bidi method setCacheBehavior defined in the bidi specs - https://w3c.github.io/webdriver-bidi/#command-network-setCacheBehavior.

I have verified that this works with the latest stable Firefox 134 and Chrome 132.

Motivation and Context

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, Tests

---

Description

• Implemented the BiDi setCacheBehavior method for Java bindings.

• Added CacheBehavior enum and SetCacheBehaviorParameters class.

• Developed unit tests for setCacheBehavior functionality.

• Enhanced network module to support cache behavior configuration.

---

Changes walkthrough 📝

	Relevant files
Enhancement	Network.java Add `setCacheBehavior` method to Network module                    java/src/org/openqa/selenium/bidi/module/Network.java Added setCacheBehavior method to the Network class. Integrated SetCacheBehaviorParameters for cache behavior configuration. +5/-0      CacheBehavior.java Introduce `CacheBehavior` enum for cache settings                java/src/org/openqa/selenium/bidi/network/CacheBehavior.java Created CacheBehavior enum to define cache behavior options. Added DEFAULT and BYPASS cache behavior types. +34/-0    SetCacheBehaviorParameters.java Add `SetCacheBehaviorParameters` for cache configuration  java/src/org/openqa/selenium/bidi/network/SetCacheBehaviorParameters.java Added SetCacheBehaviorParameters class for cache behavior configuration. Supported optional context IDs for targeted cache behavior. Implemented toMap method for parameter serialization. +46/-0
Tests	NetworkCommandsTest.java Add tests for `setCacheBehavior` in Network module              java/test/org/openqa/selenium/bidi/network/NetworkCommandsTest.java Added tests for setCacheBehavior functionality. Tested BYPASS and DEFAULT cache behaviors with and without context IDs. Verified exception handling for invalid context IDs. +61/-0

---

Need help?

Type /help how to ... in the comments thread for any question about Qodo Merge usage.

Check out the documentation for more information.

[qodo-merge-pro]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

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

🧪 PR contains tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Potential Bug The toMap() method creates a new Map instance for each condition, which could lead to inconsistent behavior. Consider using a mutable map builder pattern for better maintainability. public Map<String, Object> toMap() { Map<String, Object> map = Map.of("cacheBehavior", cacheBehavior.toString()); if (contexts != null && !contexts.isEmpty()) { return Map.of("cacheBehavior", cacheBehavior.toString(), "contexts", contexts); } return map; }

[qodo-merge-pro]

PR Code Suggestions ✨

Explore these optional code suggestions:

Category	Suggestion	Score
General	✅ Optimize map creation efficiency Suggestion Impact: The commit directly implements the suggestion by replacing Map.of() calls with a single mutable HashMap and using put() operations code diff: - Map<String, Object> map = Map.of("cacheBehavior", cacheBehavior.toString()); + Map<String, Object> map = new HashMap<>(); + map.put("cacheBehavior", cacheBehavior.toString()); if (contexts != null && !contexts.isEmpty()) { - return Map.of("cacheBehavior", cacheBehavior.toString(), "contexts", contexts); + map.put("contexts", contexts); } The toMap() method creates new Map instances unnecessarily. Optimize by using a single mutable map and conditionally adding the contexts. java/src/org/openqa/selenium/bidi/network/SetCacheBehaviorParameters.java [37-45] public Map<String, Object> toMap() { - Map<String, Object> map = Map.of("cacheBehavior", cacheBehavior.toString()); - + Map<String, Object> map = new HashMap<>(); + map.put("cacheBehavior", cacheBehavior.toString()); + if (contexts != null && !contexts.isEmpty()) { - return Map.of("cacheBehavior", cacheBehavior.toString(), "contexts", contexts); + map.put("contexts", contexts); } - + return map; } Apply this suggestion Suggestion importance[1-10]: 6 Why: The suggestion improves code efficiency by replacing immutable Map.of() calls with a single mutable HashMap, reducing object creation overhead and making the code more maintainable. While valid, this is a minor optimization with moderate impact.	6

[pujagani]

Thank you! @navin772 LGTM

[navin772]

The CI failures are not relevant to the changes done in this PR.