--search / -s / --print / --preview: list the tests the current selection matches,
without running them.
Scans the selected files and resolves which of their tests the current selection matches — no browser, no bundle, no execution.
One test found by the static scan, named exactly as QUnit would name it.
-
file: string
Absolute path of the file it was declared in — used to apply that file's line targets.
-
fullName: string
"Module > Sub: test name"— the string a filter matches against. -
line: number
1-based line of the declaration.
-
modules: string[]
The QUnit module path it is declared under; empty for a top-level test.
-
name: string
The test's own name.
What the static scan found, before anything is printed.
-
files: number
How many files were scanned.
-
filter: string
The expression matched against, or
undefinedwhen everything was listed. -
matches: FoundTest[]
The tests the current selection matches, in declaration order.
-
total: number
Every listable test found, matched or not.
-
unlistable: UnlistableCounts
What the scan could not name, split by cause.
-
warnings: string[]
Line-target resolution warnings, in input order.
Why some declarations could not be listed, split by cause.
-
computedNames: number
Declarations whose name is computed at run time —
test(`case ${index}`). -
silent: number
Files that parsed but declared no test the scan could see, e.g. via a local alias.
-
total: number
The three below, added up.
-
unparseable: number
Files that could not be read or parsed at all.
Usage
import * as mod from "lib/commands/search.ts";