playwright-roll

What problem does it solve?

Provides a structured, repeatable workflow and guidance for updating the Playwright Java client to a new upstream release, resolving generator and implementation mismatches, and ensuring the Java bindings, driver resources, and tests are in sync with the upstream JavaScript implementation.

Core Features & Use Cases

• Version bump and driver refresh: Run the roll pipeline to bump DRIVER_VERSION, download updated drivers, and regenerate api.json and Java interfaces.
• API generator and Impl fixes: Guidance for updating ApiGenerator mappings, imports, and generated interfaces, and for implementing missing or changed methods in *Impl classes.
• Test porting and debugging: Instructions for porting upstream tests, diagnosing hanging tests, rebuilding driver-bundle, and running targeted Maven test invocations.
• Use Case: A maintainer performing a release roll uses the scripts and this checklist to update driver assets, regenerate APIs, fix compilation errors, and validate the full test suite.

Quick Start

Run the repository's roll_driver.sh script, follow the ROLLING.md checklist to regenerate the API and driver resources, then rebuild driver-bundle and run Maven to compile and fix any generator or Impl errors.