feat(assertions): add expect.soft() for collecting multiple failures#3065
Open
Skn0tt wants to merge 1 commit intomicrosoft:mainfrom
Open
feat(assertions): add expect.soft() for collecting multiple failures#3065Skn0tt wants to merge 1 commit intomicrosoft:mainfrom
Skn0tt wants to merge 1 commit intomicrosoft:mainfrom
Conversation
Adds JS-style soft assertions: `expect.soft(locator).to_have_text(...)` records the failure into a per-scope collector instead of raising. A collector scope is established by `pytest-playwright>=0.7.3` / `pytest-playwright-asyncio>=0.7.3` via an autouse fixture that re-raises collected failures (or a `BaseExceptionGroup`) at end of test. Outside of an active scope, soft assertions raise `RuntimeError` to make the missing plugin requirement obvious instead of silently behaving as hard assertions. References microsoft#1272
dgozman
approved these changes
May 5, 2026
| """ | ||
| Creates a [soft assertion](https://playwright.dev/python/docs/test-assertions#soft-assertions). | ||
| Failing soft assertions do not abort test execution, but mark the test | ||
| as failed. Multiple failures from the same test are surfaced together |
Contributor
There was a problem hiding this comment.
Let's mention this requires the pytest-playwright plugin.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
expect.soft(locator).to_have_text(...)that records failures into a per-scope collector instead of raising.BaseExceptionGroup) at end of test.expect.soft(...).<assertion>(...)raisesRuntimeErrorso the missing plugin requirement is obvious instead of silently behaving as a hard assertion.Fixes #1272
Companion PR (pytest plugin integration): microsoft/playwright-pytest#312