Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion COMPATIBILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -281,7 +281,7 @@ Upstream's `4982d8d` (#1333) documents that the browser engine's semantic tree l

## Migration guides

`docs-site/src/content/docs/migrate/` ports upstream's `docs/migrate/*.mdx` (`index`, `playwright`, `selenium`, `cypress`, `detox`, `maestro`, `testerarmy`) as read at `7b1b8b27` (`8537abc7`, tester-army/e2e#1441; `b81b7d75`, tester-army/e2e#1411; `d52e9b01`, tester-army/e2e#1468; `a60310f9`, tester-army/e2e#1508; `f6d0679f`, tester-army/e2e#1361). They keep upstream's file names, headings, and order. Each guide's tables use the port's C# names, and the sidebar has a Migrate group. Differences:
`docs-site/src/content/docs/migrate/` ports upstream's `docs/migrate/*.mdx` (`index`, `playwright`, `selenium`, `cypress`, `detox`, `maestro`, `testerarmy`) as read at `7b1b8b27` (`8537abc7`, tester-army/e2e#1441; `b81b7d75`, tester-army/e2e#1411; `d52e9b01`, tester-army/e2e#1468; `a60310f9`, tester-army/e2e#1508; `0852e61`, tester-army/e2e#1545; `f6d0679f`, tester-army/e2e#1361). They keep upstream's file names, headings, and order. Each guide's tables use the port's C# names, and the sidebar has a Migrate group. Differences:

- The `playwright` guide maps Playwright for .NET (`PageTest`, `ContextOptions()`, `Page.GetByRole(AriaRole...)`), where upstream maps Node Playwright. Playwright .NET has no `playwright.config.ts`, so the config tables map `BrowserNewContextOptions`, `.runsettings`, and the environment variables instead of `testDir`, `webServer`, `projects`, and `reporter`. The `selenium` guide maps Selenium for .NET, where upstream's example is Java. The `cypress`, `detox`, `maestro`, and `testerarmy` guides keep their source runners and write the target in C#, in a new .NET test project beside the old suite.
- Every code sample has an NUnit form, and an xUnit v3 form where the two differ. A short NUnit and xUnit table in the overview replaces upstream's `test`, `describe`, hook, tag, and retry names.
Expand All @@ -290,6 +290,7 @@ Upstream's `4982d8d` (#1333) documents that the browser engine's semantic tree l
- No counterpart in the port, marked `missing` or `by design` in the tables: `e2e run` and `e2e list` (use `dotnet test`), the `tests`, `workers`, `output`, `maxDuration`, `--shard`, `--watch`, `--changed-since`, `--repeat-each`, `--max-failures`, and `--update-snapshots` flags and keys (the framework owns selection, retries, and parallelism; `--last-failed` is the `E2E_LAST_FAILED` variable and the `LastFailed` member of the run fixture, see [Test filters](#test-filters)), `describe` options (`serial`, `skip`, `retries`, `timeout`), `test.extend` fixtures and `base.extend` page objects as fixtures (a page object takes `Screen` and `Browser` in a `[SetUp]` or `InitializeAsync`), several targets in one run (the port runs one), the HTML and markdown run summaries, `unique()` as a free function (`Values.Unique`), `credentials` entries for TOTP (`secrets` hold values, not code), and the `inbox` credential. A row names a feature with `Not yet` where the port has a symbol missing from its locator set, such as the tap `position`, `TapAt`, and the screen-level `Swipe`.
- The `detox`, `maestro`, and `testerarmy` rows that use `ToHaveScreenshotAsync` on a device say the port documents the matcher for the web engine only. Nothing in the port runs it on a device.
- The prompt's step to port `.detoxrc.js` and `config.yaml` into one device target relies on `E2E_MOBILE_PLATFORM` and `E2E_MOBILE_APP_PATH` to switch between iOS and Android, since `e2e.config.json` holds one target (see [MobileAppTest](#mobileapptest-not-in-upstream)).
- From `0852e61` (tester-army/e2e#1545) the `playwright` guide mirrors only what the port does. Not mirrored, because the port has no such feature: the `workers` and `retries` limits, `test.skip`, `test.fail`, `test.use`, hook and `beforeAll` rules, the `--grep`, `--reporter`, `--trace`, `-u`, and `file:line` flag rows, `expect.closeTo`, and the value-matcher list (the framework owns them). Not verified in the port, so left out: the `**/` route glob rule and the hidden `iframe` visibility note.
- The snippets were written against the port's public API and compiled by reading, not run. The docs site build checks the pages, not the C#.
- No tests: upstream added none for these pages, and no `src/` symbol changed.

Expand Down
Loading
Loading