Skip to content

docs(migration): add "Coming from Playwright" bridge page - #16

Merged
shossain786 merged 1 commit into
masterfrom
docs/coming-from-playwright
Jul 14, 2026
Merged

shossain786 merged 1 commit into
masterfrom
docs/coming-from-playwright

Conversation

@shossain786

Copy link
Copy Markdown
Contributor

Closes #11

What

Adds docs-site/docs/migration/coming-from-playwright.md — a bridge, not a migration/replacement guide for teams who like Playwright's ergonomics but live in the Selenium / Java / JVM world.

Framing (per our canonical positioning)

Explicitly does not claim to replace Playwright. Honest familiar-vs-different structure:

  • What's familiar — accessibility-first getByRole/getByLabel/getByText locators (with a Playwright → Selenium Boot API mapping table), auto-waiting, web-first assertThat(...), convention over configuration.
  • What's genuinely different — architecture (WebDriver / W3C protocol vs Playwright's context model), language/runtime (JVM-only, runs your installed browsers via Selenium Manager), and Grid/scaling (Selenium Grid + TestNG parallelism).
  • "When to use which" table that honestly points greenfield/no-Selenium teams at Playwright.

Acceptance criteria

  • Familiar-vs-different framing, honest about differences
  • Does not claim to replace Playwright
  • description: frontmatter; linked in the Migration sidebar; build passes

All example APIs (getByRole, assertThat(...).hasText(...), WaitEngine) verified against the source.

🤖 Generated with Claude Code

Closes #11

A bridge, not a replacement guide — explicitly does not claim to replace
Playwright. Familiar-vs-different framing: what's familiar (accessibility-
first getByRole/getByLabel locators, auto-waiting, web-first assertThat,
convention over config) with a Playwright->Selenium Boot API mapping, and
what's genuinely different (WebDriver/W3C architecture, JVM/Java runtime
using installed browsers, Selenium Grid scaling). Includes an honest
"when to use which" table. Added to the Migration sidebar.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@shossain786
shossain786 merged commit 9aa418c into master Jul 14, 2026
2 checks passed
@shossain786
shossain786 deleted the docs/coming-from-playwright branch July 14, 2026 03:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: "Coming from Playwright" bridge page

1 participant