How to File a Bug Report That Actually Gets Resolved

Make sure you’re on the latest Playwright release before filing. Check existing GitHub issues to avoid duplicates.

Use the Template

Follow the Bug Report template. It guides you step-by-step:

We can't parse your entire code base. Reduce it down to the absolute essentials:

Start a fresh project (
```
npm init playwright@latest new-project
```
).
Add only the code/DOM needed to show the problem.
Only use major frameworks if necessary (React, Angular, static HTTP server, etc.).
Avoid adding extra libraries unless absolutely necessary. Note that we won't install any suspect dependencies.

Most issues that lack a repro turn out to be misconfigurations or usage errors.
We can't fix problems if we can’t reproduce them ourselves.
We can’t debug entire private projects or handle sensitive credentials.
Each confirmed bug will have a test in our repo, so your repro must be as clean as possible.

A well-isolated bug speeds up verification and resolution. Minimal, public repro or it’s unlikely we can assist.

Make sure you’re on the latest Playwright release before filing. Check existing GitHub issues to avoid duplicates.

Follow the Bug Report template. It guides you step-by-step:

We can't parse your entire code base. Reduce it down to the absolute essentials:

Start a fresh project (
```
npm init playwright@latest new-project
```
).
Add only the code/DOM needed to show the problem.
Only use major frameworks if necessary (React, Angular, static HTTP server, etc.).
Avoid adding extra libraries unless absolutely necessary. Note that we won't install any suspect dependencies.

Most issues that lack a repro turn out to be misconfigurations or usage errors.
We can't fix problems if we can’t reproduce them ourselves.
We can’t debug entire private projects or handle sensitive credentials.
Each confirmed bug will have a test in our repo, so your repro must be as clean as possible.

A well-isolated bug speeds up verification and resolution. Minimal, public repro or it’s unlikely we can assist.