# What changed in @flakiness/playwright

> 40 changes in @flakiness/playwright 1 to 2 from its official release notes, upgrade guides and advisories: 7 breaking, 12 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/npm/@flakiness/playwright/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @flakiness/playwright 2

### Breaking changes

- The separate balanced-sharding executable is gone; configure shardBalancing and run plain playwright test --shard=N/M instead. (2.0.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.0)
- The supported Node.js engine range now starts at 22.9.0; Node 20 has been dropped. (2.0.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.0)
- open now defaults to 'never', so the reporter prints the flakiness show command instead of launching a browser; set it to 'on-failure' to restore the old behavior. (2.0.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.0)
- Balanced sharding now requires a timings file, produced with flakiness-playwright-timings build or fetch and committed, making shard splits stable across runs. (2.0.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.0)

### New APIs and options

- GitLab CI/CD uploads can authenticate without an access token by declaring an id_tokens entry named FLAKINESS_ID_TOKEN with an aud matching flakinessProject. (2.0.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.0)
- Configure balanced sharding as a reporter option and use Playwright's native sharding command. (2.0.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.0)

### Behavior and default changes

- Balanced sharding requires Playwright 1.62+; on older versions the reporter warns and Playwright's native sharding applies. (2.0.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.0)

### Tooling

- Each shard prints timings coverage, predicted per-shard loads, and a balance percentage before the run, then the predicted-vs-actual delta after it. (2.0.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.0)

### Fixes and other changes

- Improves support for serial suites. (2.0.3) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.3)
- Fixes a corner case in the sharding algorithm. (2.0.2) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.2)
- Improves the shard selection heuristic. (2.0.2) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.2)
- Node 20 support was brought back, allowing developers to use the package with Node 20 again. (2.0.1) — [release notes](https://github.com/flakiness/playwright/releases/tag/v2.0.1)

## @flakiness/playwright 1

### Breaking changes

- Playwright project metadata is no longer used to define timelines. (1.8.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.8.0)
- Run titles are no longer auto-detected. (1.6.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.6.0)
- A Flakiness Report is no longer generated when no Playwright project is given. (1.2.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.2.0)

### New APIs and options

- The flakiness-playwright-shard command supports the --list flag. (1.18.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.18.0)
- Adds a fetch subcommand to the timings binary. (1.17.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.17.0)
- Adds a flag to read test duration hints. (1.17.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.17.0)
- Runs balanced shards using --shard; Playwright test arguments pass through as usual. (1.11.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.11.0)
- Configure the reporter with a Flakiness project so balanced sharding can use its historical durations. (1.11.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.11.0)
- Introduces perfect sharding. (1.10.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.10.0)
- Embeds information about the runtime, test runner, and reporter. (1.9.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.9.0)
- Attachments are attributed to steps, making their association with individual steps available to developers. (1.7.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.7.0)
- Adds a title option to name reports. (1.5.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.5.0)
- Adds support for Github OIDC; see the uploading reports documentation for details. (1.1.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.1.0)

### Behavior and default changes

- Sharded runs now generate a default title. (1.15.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.15.0)
- The Durations API supports anonymous access. (1.15.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.15.0)
- The sharding algorithm was improved. (1.13.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.13.0)
- Sharding now applies only to leaf projects and tests. (1.11.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.11.0)
- Stdio is represented as a unified array with real-time timestamps. (1.7.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.7.0)

### Tooling

- Introduces a new binary for working with Playwright test timings. (1.17.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.17.0)
- Uses historical durations from Flakiness.io to generate a Playwright --test-list for each shard, aiming to make CI shards finish closer together. (1.11.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.11.0)

### Fixes and other changes

- Anonymous Playwright projects are now properly named. (1.17.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.17.0)
- Sharding now respects --fully-parallel. (1.16.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.16.0)
- The telemetry timer no longer retains the host process. (1.14.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.14.0)
- Tests from serial suites are no longer sharded. (1.12.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.12.0)
- Only projects that were actually executed are reported. (1.8.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.8.0)
- PNPM is now properly detected for the show-report message. (1.4.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.4.0)
- Avoids the “dynamic require of tty is not supported” error. (1.3.2) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.3.2)
- Support initialized repositories that have no commits. (1.3.0) — [release notes](https://github.com/flakiness/playwright/releases/tag/v1.3.0)
