root
- CLI:
-r, --root <path>
- Config: root
Kořenový adresář projektu.
config
- CLI:
-c, --config <path>
Cesta k souboru s konfigurací.
update
- CLI:
-u, --update
- Config: update
Aktualizuje snímky (snapshots).
watch
- CLI:
-w, --watch
- Config: watch
Povolí režim sledování změn (watch mode).
testNamePattern
- CLI:
-t, --testNamePattern <pattern>
- Config: testNamePattern
Spouští pouze testy, jejichž plné názvy odpovídají zadanému regulárnímu výrazu.
dir
- CLI:
--dir <path>
- Config: dir
Základní adresář pro prohledávání testovacích souborů.
ui
- CLI:
--ui
- Config: ui
Povolí uživatelské rozhraní (UI).
open
- CLI:
--open
- Config: open
Automaticky otevře UI v prohlížeči (výchozí: !process.env.CI
).
api.port
- CLI:
--api.port [port]
Určuje port serveru. Pokud je port již obsazen, Vite se automaticky pokusí o další dostupný port, takže se nemusí jednat o skutečný port, na kterém server nakonec poslouchá. Pokud je hodnota true
, bude nastaven na 51204
.
api.host
- CLI:
--api.host [host]
Určuje, na kterých IP adresách má server naslouchat. Nastavte na 0.0.0.0
nebo true
, aby server naslouchal na všech adresách, včetně LAN a veřejných adres.
api.strictPort
- CLI:
--api.strictPort
Pokud je true
, aplikace se ukončí, pokud je port již používán, namísto automatického pokusu o další dostupný port.
silent
- CLI:
--silent
- Config: silent
Potlačí výstup konzole z testů.
hideSkippedTests
- CLI:
--hideSkippedTests
Skryje záznamy o přeskočených testech.
reporters
- CLI:
--reporter <name>
- Config: reporters
Určuje reportéry.
outputFile
- CLI:
--outputFile <filename/-s>
- Config: outputFile
Zapisuje výsledky testů do souboru, pokud je specifikován podporovaný reportér. Pro individuální výstupy více reportérů použijte tečkovou notaci cac (příklad: --outputFile.tap=./tap.txt
).
coverage.all
- CLI:
--coverage.all
- Config: coverage.all
Určuje, zda zahrnout všechny soubory, včetně netestovaných, do zprávy o pokrytí.
coverage.provider
- CLI:
--coverage.provider <name>
- Config: coverage.provider
Vybere nástroj pro sběr pokrytí. Dostupné hodnoty jsou: "v8", "istanbul" a "custom".
coverage.enabled
- CLI:
--coverage.enabled
- Config: coverage.enabled
Povoluje sběr pokrytí testů. Lze přepsat pomocí volby CLI --coverage
(výchozí: false
).
coverage.include
- CLI:
--coverage.include <pattern>
- Config: coverage.include
Soubory zahrnuté do pokrytí jako glob vzory. Lze specifikovat vícekrát při použití více vzorů (výchozí: **
).
coverage.exclude
- CLI:
--coverage.exclude <pattern>
- Config: coverage.exclude
Soubory, které mají být vyloučeny z pokrytí. Lze specifikovat vícekrát při použití více vzorů (výchozí: Navštivte coverage.exclude
).
coverage.extension
- CLI:
--coverage.extension <extension>
- Config: coverage.extension
Přípony souborů, které mají být zahrnuty do pokrytí. Lze specifikovat vícekrát pro více přípon (výchozí: [".js", ".cjs", ".mjs", ".ts", ".mts", ".tsx", ".jsx", ".vue", ".svelte"]
).
coverage.clean
- CLI:
--coverage.clean
- Config: coverage.clean
Vyčistí výsledky pokrytí před spuštěním testů (výchozí: true
).
coverage.cleanOnRerun
- CLI:
--coverage.cleanOnRerun
- Config: coverage.cleanOnRerun
Vyčistí report pokrytí při opětovném spuštění v režimu sledování (výchozí: true
).
coverage.reportsDirectory
- CLI:
--coverage.reportsDirectory <path>
- Config: coverage.reportsDirectory
Adresář pro zápis reportu pokrytí (výchozí: ./coverage
).
coverage.reporter
- CLI:
--coverage.reporter <name>
- Config: coverage.reporter
Reportéry pokrytí k použití. Více informací na coverage.reporter
(výchozí: ["text", "html", "clover", "json"]
).
coverage.reportOnFailure
- CLI:
--coverage.reportOnFailure
- Config: coverage.reportOnFailure
Generuje report pokrytí i v případě selhání testů (výchozí: false
).
coverage.allowExternal
- CLI:
--coverage.allowExternal
- Config: coverage.allowExternal
Sbírá pokrytí souborů mimo kořen projektu (výchozí: false
).
coverage.skipFull
- CLI:
--coverage.skipFull
- Config: coverage.skipFull
Nezobrazuje soubory se 100% pokrytím příkazů, větví a funkcí (výchozí: false
).
coverage.thresholds.100
- CLI:
--coverage.thresholds.100
- Config: coverage.thresholds.100
Zkratka pro nastavení všech prahových hodnot pokrytí na 100 % (výchozí: false
).
coverage.thresholds.perFile
- CLI:
--coverage.thresholds.perFile
- Config: coverage.thresholds.perFile
Kontroluje prahové hodnoty pro každý soubor. Skutečné prahové hodnoty viz --coverage.thresholds.lines
, --coverage.thresholds.functions
, --coverage.thresholds.branches
a --coverage.thresholds.statements
(výchozí: false
).
coverage.thresholds.autoUpdate
- CLI:
--coverage.thresholds.autoUpdate
- Config: coverage.thresholds.autoUpdate
Aktualizuje prahové hodnoty: "lines", "functions", "branches" a "statements" do konfiguračního souboru, pokud je aktuální pokrytí nad nakonfigurovanými prahovými hodnotami (výchozí: false
).
coverage.thresholds.lines
- CLI:
--coverage.thresholds.lines <number>
Prahová hodnota pro pokrytí řádků. Pro více informací navštivte istanbuljs. Tato možnost není dostupná pro vlastní poskytovatele pokrytí.
coverage.thresholds.functions
- CLI:
--coverage.thresholds.functions <number>
Prahová hodnota pro pokrytí funkcí. Pro více informací navštivte istanbuljs. Tato možnost není dostupná pro vlastní poskytovatele pokrytí.
coverage.thresholds.branches
- CLI:
--coverage.thresholds.branches <number>
Prahová hodnota pro pokrytí větví. Pro více informací navštivte istanbuljs. Tato možnost není dostupná pro vlastní poskytovatele pokrytí.
coverage.thresholds.statements
- CLI:
--coverage.thresholds.statements <number>
Prahová hodnota pro pokrytí příkazů. Pro více informací navštivte istanbuljs. Tato možnost není dostupná pro vlastní poskytovatele pokrytí.
coverage.ignoreClassMethods
- CLI:
--coverage.ignoreClassMethods <name>
- Config: coverage.ignoreClassMethods
Pole názvů metod tříd, které se mají ignorovat při sběru pokrytí. Pro více informací navštivte istanbuljs. Tato možnost je dostupná pouze pro poskytovatele Istanbul (výchozí: []
).
coverage.processingConcurrency
- CLI:
--coverage.processingConcurrency <number>
- Config: coverage.processingConcurrency
Limit souběžnosti pro zpracování výsledků pokrytí (výchozí: menší z hodnot 20 a počtu CPU).
coverage.customProviderModule
- CLI:
--coverage.customProviderModule <path>
- Config: coverage.customProviderModule
Určuje název modulu nebo cestu k modulu vlastního poskytovatele pokrytí. Pro více informací navštivte Custom Coverage Provider. Tato možnost je dostupná pouze pro vlastní poskytovatele pokrytí.
coverage.watermarks.statements
- CLI:
--coverage.watermarks.statements <watermarks>
Horní a dolní hranice (watermarks) pro pokrytí příkazů ve formátu <high>,<low>
.
coverage.watermarks.lines
- CLI:
--coverage.watermarks.lines <watermarks>
Horní a dolní hranice (watermarks) pro pokrytí řádků ve formátu <high>,<low>
.
coverage.watermarks.branches
- CLI:
--coverage.watermarks.branches <watermarks>
Horní a dolní hranice (watermarks) pro pokrytí větví ve formátu <high>,<low>
.
coverage.watermarks.functions
- CLI:
--coverage.watermarks.functions <watermarks>
Horní a dolní hranice (watermarks) pro pokrytí funkcí ve formátu <high>,<low>
.
mode
- CLI:
--mode <name>
- Config: mode
Nastaví režim Vite (výchozí: test
nebo benchmark
).
workspace
- CLI:
--workspace <path>
- Config: workspace
Cesta ke konfiguračnímu souboru pracovního prostoru.
isolate
- CLI:
--isolate
- Config: isolate
Spustí každý testovací soubor izolovaně. Pro vypnutí izolace použijte --no-isolate
(výchozí: true
).
globals
- CLI:
--globals
- Config: globals
Globálně injektuje API funkce.
dom
- CLI:
--dom
Simuluje API prohlížeče pomocí happy-dom.
browser.enabled
- CLI:
--browser.enabled
- Config: browser.enabled
Spustí testy v prohlížeči (výchozí: false
).
browser.name
- CLI:
--browser.name <name>
- Config: browser.name
Spustí všechny testy v konkrétním prohlížeči. Některé prohlížeče jsou dostupné pouze pro konkrétní poskytovatele (viz --browser.provider
). Více informací na browser.name
.
browser.headless
- CLI:
--browser.headless
- Config: browser.headless
Spustí prohlížeč v bezhlavém režimu (tj. bez otevření grafického uživatelského rozhraní). Pokud spouštíte Vitest v CI, bude tato možnost ve výchozím nastavení povolena (výchozí: process.env.CI
).
browser.api.port
- CLI:
--browser.api.port [port]
- Config: browser.api.port
Určuje port serveru. Pokud je port již obsazen, Vite se automaticky pokusí o další dostupný port, takže se nemusí jednat o skutečný port, na kterém server nakonec poslouchá. Pokud je hodnota true
, bude nastaven na 63315
.
browser.api.host
- CLI:
--browser.api.host [host]
- Config: browser.api.host
Určuje, na kterých IP adresách má server naslouchat. Nastavte na 0.0.0.0
nebo true
pro naslouchání na všech adresách, včetně LAN a veřejných adres.
browser.api.strictPort
- CLI:
--browser.api.strictPort
- Config: browser.api.strictPort
Pokud je true
, aplikace se ukončí, pokud je port již používán, namísto automatického pokusu o další dostupný port.
browser.provider
- CLI:
--browser.provider <name>
- Config: browser.provider
Poskytovatel použitý ke spuštění testů prohlížeče. Některé prohlížeče jsou dostupné pouze pro konkrétní poskytovatele. Může být "webdriverio", "playwright", "preview" nebo cesta k vlastnímu poskytovateli. Více informací na browser.provider
(výchozí: "preview"
).
browser.providerOptions
- CLI:
--browser.providerOptions <options>
- Config: browser.providerOptions
Možnosti, které jsou předány poskytovateli prohlížeče. Více informací na browser.providerOptions
.
browser.isolate
- CLI:
--browser.isolate
- Config: browser.isolate
Spustí každý testovací soubor prohlížeče izolovaně. Pro vypnutí izolace použijte --browser.isolate=false
(výchozí: true
).
browser.ui
- CLI:
--browser.ui
- Config: browser.ui
Zobrazí Vitest UI při spouštění testů (výchozí: !process.env.CI
).
browser.fileParallelism
- CLI:
--browser.fileParallelism
- Config: browser.fileParallelism
Určuje, zda se mají soubory testů prohlížeče spouštět paralelně. Pro vypnutí použijte --browser.fileParallelism=false
(výchozí: true
).
pool
- CLI:
--pool <pool>
- Config: pool
Určuje typ poolu (fondu) pro spouštění testů, pokud neběží v prohlížeči (výchozí: threads
).
poolOptions.threads.isolate
- CLI:
--poolOptions.threads.isolate
- Config: poolOptions.threads.isolate
Izoluje testy v poolu vláken (výchozí: true
).
poolOptions.threads.singleThread
- CLI:
--poolOptions.threads.singleThread
- Config: poolOptions.threads.singleThread
Spustí testy v jednom vlákně (výchozí: false
).
poolOptions.threads.maxThreads
- CLI:
--poolOptions.threads.maxThreads <workers>
- Config: poolOptions.threads.maxThreads
Maximální počet nebo procento vláken, ve kterých se mají spouštět testy.
poolOptions.threads.minThreads
- CLI:
--poolOptions.threads.minThreads <workers>
- Config: poolOptions.threads.minThreads
Minimální počet nebo procento vláken, ve kterých se mají spouštět testy.
poolOptions.threads.useAtomics
- CLI:
--poolOptions.threads.useAtomics
- Config: poolOptions.threads.useAtomics
Používá Atomics pro synchronizaci vláken. To může v některých případech zlepšit výkon, ale může způsobit chybu segmentace (segfault) ve starších verzích Node (výchozí: false
).
poolOptions.vmThreads.isolate
- CLI:
--poolOptions.vmThreads.isolate
- Config: poolOptions.vmThreads.isolate
Izoluje testy v poolu VM vláken (výchozí: true
).
poolOptions.vmThreads.singleThread
- CLI:
--poolOptions.vmThreads.singleThread
- Config: poolOptions.vmThreads.singleThread
Spustí testy v jednom VM vlákně (výchozí: false
).
poolOptions.vmThreads.maxThreads
- CLI:
--poolOptions.vmThreads.maxThreads <workers>
- Config: poolOptions.vmThreads.maxThreads
Maximální počet nebo procento VM vláken, ve kterých se mají spouštět testy.
poolOptions.vmThreads.minThreads
- CLI:
--poolOptions.vmThreads.minThreads <workers>
- Config: poolOptions.vmThreads.minThreads
Minimální počet nebo procento VM vláken, ve kterých se mají spouštět testy.
poolOptions.vmThreads.useAtomics
- CLI:
--poolOptions.vmThreads.useAtomics
- Config: poolOptions.vmThreads.useAtomics
Používá Atomics pro synchronizaci VM vláken. To může v některých případech zlepšit výkon, ale může způsobit chybu segmentace (segfault) ve starších verzích Node (výchozí: false
).
poolOptions.vmThreads.memoryLimit
- CLI:
--poolOptions.vmThreads.memoryLimit <limit>
- Config: poolOptions.vmThreads.memoryLimit
Limit paměti pro fond VM vláken. Pokud zaznamenáte úniky paměti, zkuste tuto hodnotu upravit.
poolOptions.forks.isolate
- CLI:
--poolOptions.forks.isolate
- Config: poolOptions.forks.isolate
Izoluje testy v poolu forků (výchozí: true
).
poolOptions.forks.singleFork
- CLI:
--poolOptions.forks.singleFork
- Config: poolOptions.forks.singleFork
Spustí testy v jednom child_process (výchozí: false
).
poolOptions.forks.maxForks
- CLI:
--poolOptions.forks.maxForks <workers>
- Config: poolOptions.forks.maxForks
Maximální počet nebo procento procesů, ve kterých se mají spouštět testy.
poolOptions.forks.minForks
- CLI:
--poolOptions.forks.minForks <workers>
- Config: poolOptions.forks.minForks
Minimální počet nebo procento procesů, ve kterých se mají spouštět testy.
poolOptions.vmForks.isolate
- CLI:
--poolOptions.vmForks.isolate
- Config: poolOptions.vmForks.isolate
Izoluje testy v poolu VM forků (výchozí: true
).
poolOptions.vmForks.singleFork
- CLI:
--poolOptions.vmForks.singleFork
- Config: poolOptions.vmForks.singleFork
Spustí testy v jednom child_process (výchozí: false
).
poolOptions.vmForks.maxForks
- CLI:
--poolOptions.vmForks.maxForks <workers>
- Config: poolOptions.vmForks.maxForks
Maximální počet nebo procento procesů, ve kterých se mají spouštět testy.
poolOptions.vmForks.minForks
- CLI:
--poolOptions.vmForks.minForks <workers>
- Config: poolOptions.vmForks.minForks
Minimální počet nebo procento procesů, ve kterých se mají spouštět testy.
poolOptions.vmForks.memoryLimit
- CLI:
--poolOptions.vmForks.memoryLimit <limit>
- Config: poolOptions.vmForks.memoryLimit
Limit paměti pro fond VM forků. Pokud zaznamenáte úniky paměti, zkuste tuto hodnotu upravit.
fileParallelism
- CLI:
--fileParallelism
- Config: fileParallelism
Určuje, zda se mají všechny testovací soubory spouštět paralelně. Pro vypnutí použijte --no-file-parallelism
(výchozí: true
).
maxWorkers
- CLI:
--maxWorkers <workers>
- Config: maxWorkers
Maximální počet nebo procento pracovních procesů (workerů), ve kterých se mají spouštět testy.
minWorkers
- CLI:
--minWorkers <workers>
- Config: minWorkers
Minimální počet nebo procento pracovních procesů (workerů), ve kterých se mají spouštět testy.
environment
- CLI:
--environment <name>
- Config: environment
Určuje prostředí spouštěče (runneru), pokud testy neběží v prohlížeči (výchozí: node
).
passWithNoTests
- CLI:
--passWithNoTests
- Config: passWithNoTests
Testy projdou, i když nejsou nalezeny žádné testy.
logHeapUsage
- CLI:
--logHeapUsage
- Config: logHeapUsage
Zobrazuje velikost haldy pro každý test při spouštění v prostředí Node.js.
allowOnly
- CLI:
--allowOnly
- Config: allowOnly
Povoluje spouštění testů a sad, které jsou označeny jako "only" (tj. pouze tyto testy/sady) (výchozí: !process.env.CI
).
dangerouslyIgnoreUnhandledErrors
- CLI:
--dangerouslyIgnoreUnhandledErrors
- Config: dangerouslyIgnoreUnhandledErrors
Ignoruje veškeré neošetřené chyby, které se vyskytnou.
sequence.shuffle.files
- CLI:
--sequence.shuffle.files
- Config: sequence.shuffle.files
Spouští soubory v náhodném pořadí. Povolení této možnosti nezajistí, že dlouho běžící testy začnou dříve (výchozí: false
).
sequence.shuffle.tests
- CLI:
--sequence.shuffle.tests
- Config: sequence.shuffle.tests
Spouští testy v náhodném pořadí (výchozí: false
).
sequence.concurrent
- CLI:
--sequence.concurrent
- Config: sequence.concurrent
Spouští testy paralelně (výchozí: false
).
sequence.seed
- CLI:
--sequence.seed <seed>
- Config: sequence.seed
Nastaví semeno pro randomizaci. Tato možnost nebude mít žádný účinek, pokud není --sequence.shuffle
povoleno (je falsy
). Více informací na stránce "Random Seed".
sequence.hooks
- CLI:
--sequence.hooks <order>
- Config: sequence.hooks
Mění pořadí, ve kterém jsou spouštěny hooky (háčky). Přijatelné hodnoty jsou: "stack", "list" a "parallel". Více informací na sequence.hooks
(výchozí: "parallel"
).
sequence.setupFiles
- CLI:
--sequence.setupFiles <order>
- Config: sequence.setupFiles
Mění pořadí, ve kterém jsou spouštěny soubory nastavení. Přijatelné hodnoty jsou: "list" a "parallel". Pokud je nastaveno na "list", soubory nastavení se spustí v pořadí, v jakém jsou definovány. Pokud je nastaveno na "parallel", spustí se soubory nastavení paralelně (výchozí: "parallel"
).
inspect
- CLI:
--inspect [[host:]port]
- Config: inspect
Povolí Node.js inspektor (výchozí: 127.0.0.1:9229
).
inspectBrk
- CLI:
--inspectBrk [[host:]port]
- Config: inspectBrk
Povolí Node.js inspektor a zastaví se před spuštěním testu.
testTimeout
- CLI:
--testTimeout <timeout>
- Config: testTimeout
Výchozí časový limit pro test v milisekundách (výchozí: 5000
).
hookTimeout
- CLI:
--hookTimeout <timeout>
- Config: hookTimeout
Výchozí časový limit pro hook (háček) v milisekundách (výchozí: 10000
).
bail
- CLI:
--bail <number>
- Config: bail
Zastaví provádění testů, pokud selže zadaný počet testů (výchozí: 0
).
retry
- CLI:
--retry <times>
- Config: retry
Opakuje test zadaný početkrát, pokud selže (výchozí: 0
).
diff
- CLI:
--diff <path>
- Config: diff
Cesta k diff konfiguraci, která bude použita pro generování rozdílového rozhraní.
exclude
- CLI:
--exclude <glob>
- Config: exclude
Další glob vzory souborů, které se mají vyloučit z testování.
expandSnapshotDiff
- CLI:
--expandSnapshotDiff
- Config: expandSnapshotDiff
Zobrazí úplný rozdíl (diff), když snapshot selže.
disableConsoleIntercept
- CLI:
--disableConsoleIntercept
- Config: disableConsoleIntercept
Zakáže automatické zachycování výstupu konzole (výchozí: false
).
typecheck.enabled
- CLI:
--typecheck.enabled
- Config: typecheck.enabled
Povoluje kontrolu typů souběžně s testy (výchozí: false
).
typecheck.only
- CLI:
--typecheck.only
- Config: typecheck.only
Spustí pouze testy kontroly typů. Tím se automaticky povolí kontrola typů (výchozí: false
).
typecheck.checker
- CLI:
--typecheck.checker <name>
- Config: typecheck.checker
Určuje nástroj pro kontrolu typů, který se má použít. Dostupné hodnoty jsou: "tsc", "vue-tsc" a cesta k spustitelnému souboru (výchozí: "tsc"
).
typecheck.allowJs
- CLI:
--typecheck.allowJs
- Config: typecheck.allowJs
Povoluje kontrolu typů souborů JavaScript. Ve výchozím nastavení přebírá hodnotu z tsconfig.json
.
typecheck.ignoreSourceErrors
- CLI:
--typecheck.ignoreSourceErrors
- Config: typecheck.ignoreSourceErrors
Ignoruje chyby typů ze zdrojových souborů.
typecheck.tsconfig
- CLI:
--typecheck.tsconfig <path>
- Config: typecheck.tsconfig
Cesta k vlastnímu souboru tsconfig
.
project
- CLI:
--project <name>
- Config: project
Název projektu, který se má spustit, pokud používáte funkci pracovního prostoru Vitest. Lze zadat vícekrát pro spuštění více projektů: --project=1 --project=2
. Projekty můžete také filtrovat pomocí zástupných znaků, jako je --project=packages*
.
slowTestThreshold
- CLI:
--slowTestThreshold <threshold>
- Config: slowTestThreshold
Prahová hodnota v milisekundách, po které je test považován za pomalý (výchozí: 300
).
teardownTimeout
- CLI:
--teardownTimeout <timeout>
- Config: teardownTimeout
Výchozí časový limit pro funkci teardown (ukončení) v milisekundách (výchozí: 10000
).
maxConcurrency
- CLI:
--maxConcurrency <number>
- Config: maxConcurrency
Maximální počet souběžně spouštěných testů v sadě (výchozí: 5
).
expect.requireAssertions
- CLI:
--expect.requireAssertions
- Config: expect.requireAssertions
Vyžaduje, aby všechny testy obsahovaly alespoň jedno tvrzení.
expect.poll.interval
- CLI:
--expect.poll.interval <interval>
- Config: expect.poll.interval
Interval dotazování v milisekundách pro tvrzení expect.poll()
(výchozí: 50
).
expect.poll.timeout
- CLI:
--expect.poll.timeout <timeout>
- Config: expect.poll.timeout
Časový limit dotazování v milisekundách pro tvrzení expect.poll()
(výchozí: 1000
).
printConsoleTrace
- CLI:
--printConsoleTrace
- Config: printConsoleTrace
Vždy tiskne trasování zásobníku konzole.
run
- CLI:
--run
Zakáže režim sledování.
color
- CLI:
--no-color
Odstraní barvy z výstupu konzole.
clearScreen
- CLI:
--clearScreen
Vyčistí obrazovku terminálu při opětovném spouštění testů v režimu sledování (výchozí: true
).
standalone
- CLI:
--standalone
Spustí Vitest bez spouštění testů. Filtry souborů budou ignorovány a testy se budou spouštět pouze při změně (výchozí: false
).