Files
Vishwas Tiwari c30354ff84 feat(test): add test.describe.fail and the fail option on describe (#1925)
* feat(test): add test.describe.fail and the fail option on describe

A test now reads fail from its groups as well as itself. Any truthy layer marks it, the innermost reason wins, and fail: false does not unmark. Refused on, inside, or around a serial group. Part of #1855.

* test(collect): check an inner group's fail reason wins over an outer one

* fix(test): type describe without a cast and point the test.fail error at describe.fail

The collection error for test.fail(condition) outside a body now names describe.fail and the describe option, since a migrating Playwright user hits it first. The Playwright migrate row gains the conditional form, and the ja/zh rows take cubic's translations.

* fix(test): validate describe.fail options before adding the mark

describe.fail copied its options with a spread before validation, so an array or a non-enumerable bad key passed where describe() rejects it. The caller's options are now validated first, then again with fail: true for the serial rules. The fail docs now say true or any string marks, since a blank string marks too.

* docs(test): say fail is refused around a serial group too

* refactor(test): validate describe options in one pass

describe.fail no longer validates twice: the serial check takes the mark into account, and registerDescribe takes api and markFail without defaults.
2026-11-21 16:25:49 +01:00
..