Per-block options
Updated May 7, 2026
The fence info string accepts these tokens after test:
| Option | Type | Effect |
|---|---|---|
name="..." | string | Use the supplied test name instead of the nearest heading. Never auto-suffixed. |
skip | flag | Emit as it.skip(...) — the test is reported but not run. |
only | flag | Emit as it.only(...) — focus only on this test in its file. |
The options follow livemark's fence-info convention: key="value" for
parametric options, bare tokens for booleans.
Naming a test explicitly
Useful when the heading is too generic or you want stable names regardless of heading edits.
```ts test name="adds two positive numbers"
expect(1 + 1).toBe(2)
```User-supplied names are passed through verbatim — no #1/#2 suffixing even
on collisions.
Skipping a test
Marks the block so vitest/jest reports it but doesn't execute it. Useful for documenting behavior that's pending or temporarily broken.
```ts test skip
// not executed
```Focusing on one test
Mirrors vitest/jest it.only(...) — only this block runs in its file; all
others are skipped.
```ts test only
expect(true).toBe(true)
```Combining options
Options can be combined freely. When both skip and only are set on the
same block, skip wins (safer default for CI: no-op the marker rather than
silently focus).
```ts test only name="focus me"
expect(true).toBe(true)
```Created with ❤ and Livemark