[Feature]: Support a Method to Explicitly Mark Test as Passed and Exit Early

[slittleton]

🚀 Feature Request

Currently, Playwright does not provide a method such as test.pass() to immediately mark a test as passed and exit early. While using return achieves a similar effect, it can be ambiguous when reviewing test logs or understanding developer intent. Having a clear, expressive way to exit a test with a "passed" status—especially under conditional scenarios—would improve readability and convey semantics more directly.

Example

1. Sometimes I need to run a test suite but some of the tests should be skipped either for time saving or they are not relevant.

2. Dynamically skipping parts of a test when preconditions are met, but still considering it a successful validation.

3. Improving clarity in CI logs by distinguishing between skipped, failed, and explicitly passed conditions.

4. Allowing finer control in custom test helpers and shared test setups.

Motivation

I believe that are a number of use cases for this functionality and I specifically find that test.skip() is often inconvenient if I want part of a test to run. This would allow us to pass a test at any point where we determine it is appropriate.

[Skn0tt]

Could you elaborate on the shortcomings of return? You can communicate intent by conventionally doing return "passed" or something else. Playwright doesn't read the return value, so you can return whatever.

[slittleton]

I see your point. Thanks for pointing that out. I think it could be useful in some circumstances where you might have to nest return statements but for most use cases that probably wont be a major issue.

Sometimes I have to write tests that have a lot of filling out forms and I end up writing utility functions to just generate dummy data to get to the next stage, or for functions that cover chunks of test steps that get reused in multiple tests. Sometimes there are multi-stage forms where the behavior of the next stage of the form changes depending on what is being tested. This requires multiple utility functions that often require some nesting. I was just thinking it would be nice to be able to just drop in a method that told the test to pass right at that point even if its deeply nested in multiple function calls. If I return from multiple points of nesting functions it could potentially get a bit unwieldy.

thanks for the reply