Parancssori felület
Parancsok
vitest
Elindítja a Vitestet az aktuális könyvtárban. Fejlesztői környezetben automatikusan figyelő (watch) módra vált, CI/CD környezetben (vagy nem interaktív terminálban) pedig futtatási (run) módba.
További paraméterként megadhatja a futtatandó tesztfájlok szűrőjét. Például:
vitest foobar
Csak azokat a tesztfájlokat futtatja, amelyek elérési útjában foobar
szerepel. Ez a szűrő kizárólag a tartalmazást ellenőrzi, és nem támogatja a reguláris kifejezéseket vagy a glob mintákat (kivéve, ha a terminálja feldolgozza, mielőtt a Vitest megkapja a szűrőt).
Vitest 3-tól kezdve a tesztet fájlnév és sorszám alapján is megadhatja:
$ vitest basic/foo.test.ts:10
WARNING
Fontos megjegyezni, hogy a Vitestnek a teljes fájlnévre van szüksége e funkció működéséhez. Ez lehet relatív az aktuális munkakönyvtárhoz képest, vagy abszolút fájlútvonal.
$ vitest basic/foo.js:10 # ✅
$ vitest ./basic/foo.js:10 # ✅
$ vitest /users/project/basic/foo.js:10 # ✅
$ vitest foo:10 # ❌
$ vitest ./basic/foo:10 # ❌
Jelenleg a Vitest a tartományokat sem támogatja:
$ vitest basic/foo.test.ts:10, basic/foo.test.ts:25 # ✅
$ vitest basic/foo.test.ts:10-25 # ❌
vitest run
Egyszeri futtatás végrehajtása figyelő mód engedélyezése nélkül.
vitest watch
Futtatja az összes tesztcsomagot, de figyeli a változásokat, és újra futtatja a teszteket, ha azok megváltoznak. Ugyanaz, mint a vitest
argumentum nélküli hívása. CI/CD környezetben, vagy ha a standard bemenet (stdin) nem TTY (azaz nem interaktív környezet), akkor vitest run
módba vált vissza.
vitest dev
A vitest watch
alias neve.
vitest related
Csak azokat a teszteket futtatja, amelyek lefedik a megadott forrásfájlokat. Statikus importok esetén működik (pl. import('./index.js')
vagy import index from './index.js
), de dinamikus importokkal nem (pl. import(filepath)
). Minden fájlnak a gyökérkönyvtárhoz viszonyítva relatív útvonalon kell lennie.
Hasznos lehet lint-staged
vagy CI beállításokkal való használatkor.
vitest related /src/index.ts /src/hello-world.js
TIP
Ne feledje, hogy a Vitest alapértelmezés szerint figyelő módban fut. Ha olyan eszközöket használ, mint a lint-staged
, akkor a --run
opciót is át kell adnia, hogy a parancs normálisan befejeződhessen.
export default {
'*.{js,ts}': 'vitest related --run',
};
vitest bench
Csak a benchmark teszteket futtatja, amelyek a teljesítményeredményeket hasonlítják össze.
vitest init
A vitest init <name>
parancs a projekt konfigurációjának beállítására használható. Jelenleg csak a browser
értéket támogatja:
vitest init browser
vitest list
A vitest list
parancs örökli a vitest
összes opcióját, hogy kiírja az összes egyező teszt listáját. Ez a parancs figyelmen kívül hagyja a reporters
opciót. Alapértelmezés szerint kiírja az összes olyan teszt nevét, amely megfelel a fájlszűrőnek és a névmintának:
vitest list filename.spec.ts -t="some-test"
describe > some-test
describe > some-test > test 1
describe > some-test > test 2
Átadhatja a --json
kapcsolót a tesztek JSON formátumban történő kiírásához vagy külön fájlba mentéséhez:
vitest list filename.spec.ts -t="some-test" --json=./file.json
Ha a --json
kapcsoló nem kap értéket, akkor a JSON kimenetet a standard kimenetre (stdout) írja.
Átadhatja a --filesOnly
kapcsolót is, hogy csak a tesztfájlokat írja ki:
vitest list --filesOnly
tests/test1.test.ts
tests/test2.test.ts
Opciók
TIP
A Vitest támogatja a camelCase és a kebab-case formátumot is a parancssori argumentumokhoz. Például a --passWithNoTests
és a --pass-with-no-tests
is működni fog (a --no-color
és a --inspect-brk
kivételek).
A Vitest az érték megadásának különböző módjait is támogatja: a --reporter dot
és a --reporter=dot
is érvényes.
Ha egy opció értékek tömbjét támogatja, akkor az opciót többször kell megadni:
vitest --reporter=dot --reporter=default
A logikai opciók no-
előtaggal tagadhatók meg. Az érték false
-ként történő megadása is működik:
vitest --no-api
vitest --api=false
root
- CLI:
-r, --root <útvonal>
- Konfiguráció: root
A projekt gyökérkönyvtára.
config
- CLI:
-c, --config <útvonal>
A konfigurációs fájl elérési útja.
update
- CLI:
-u, --update
- Konfiguráció: update
Pillanatfelvételek frissítése.
watch
- CLI:
-w, --watch
- Konfiguráció: watch
Figyelő mód engedélyezése a fájlváltozásokra.
testNamePattern
- CLI:
-t, --testNamePattern <minta>
- Konfiguráció: testNamePattern
Tesztek futtatása a megadott reguláris kifejezés mintájának megfelelő teljes nevekkel.
dir
- CLI:
--dir <útvonal>
- Konfiguráció: dir
Alapkönyvtár a tesztfájlok kereséséhez.
ui
- CLI:
--ui
- Konfiguráció: ui
A felhasználói felület engedélyezése.
open
- CLI:
--open
- Konfiguráció: open
A felhasználói felület automatikus megnyitása (alapértelmezett: !process.env.CI
).
api.port
- CLI:
--api.port [port]
A szerver portjának megadása. Megjegyzés: ha a port már foglalt, a Vite automatikusan megpróbálja a következő elérhető portot, így ez nem feltétlenül az a port lesz, amelyen a szerver végül figyel. Ha true
értékre van állítva, akkor 51204
lesz.
api.host
- CLI:
--api.host [host]
Adja meg, mely IP-címeken figyeljen a szerver. Állítsa 0.0.0.0
értékre vagy true
-ra, hogy minden címen figyeljen, beleértve a LAN és nyilvános címeket is.
api.strictPort
- CLI:
--api.strictPort
Állítsa true
értékre, hogy kilépjen, ha a port már használatban van, ahelyett, hogy automatikusan megpróbálná a következő elérhető portot.
silent
- CLI:
--silent [érték]
- Konfiguráció: silent
A tesztek konzolkimenetének elnémítása. Használja a 'passed-only'
értéket, hogy csak a sikertelen tesztek naplóit lássa.
hideSkippedTests
- CLI:
--hideSkippedTests
A kihagyott tesztek naplóbejegyzéseinek elrejtése.
reporters
- CLI:
--reporter <név>
- Konfiguráció: reporters
Jelentéskészítők megadása (default, basic, blob, verbose, dot, json, tap, tap-flat, junit, hanging-process, github-actions).
outputFile
- CLI:
--outputFile <fájlnév/-ek>
- Konfiguráció: outputFile
Teszteredmények fájlba írása, ha támogató jelentéskészítő is meg van adva. Használja a cac pontjelölését több jelentéskészítő egyedi kimenetéhez (például: --outputFile.tap=./tap.txt
).
coverage.all
- CLI:
--coverage.all
- Konfiguráció: coverage.all
Belefoglalja-e az összes fájlt, beleértve a teszteletleneket is, a lefedettségi jelentésbe.
coverage.provider
- CLI:
--coverage.provider <név>
- Konfiguráció: coverage.provider
Lefedettségmérési eszköz kiválasztása. Elérhető értékek: "v8", "istanbul" és "custom".
coverage.enabled
- CLI:
--coverage.enabled
- Konfiguráció: coverage.enabled
Lefedettségmérés engedélyezése. Felülírható a --coverage
CLI opcióval. (alapértelmezett: false
)
coverage.include
- CLI:
--coverage.include <minta>
- Konfiguráció: coverage.include
Lefedettségmérésbe bevont fájlok glob minták szerint. Több minta használatakor többször is megadható (alapértelmezett: **
).
coverage.exclude
- CLI:
--coverage.exclude <minta>
- Konfiguráció: coverage.exclude
Lefedettségmérésből kizárt fájlok. Több kiterjesztés használatakor többször is megadható. (alapértelmezett: Lásd a coverage.exclude
oldalt).
coverage.extension
- CLI:
--coverage.extension <kiterjesztés>
- Konfiguráció: coverage.extension
A lefedettségbe belefoglalandó kiterjesztés. Több kiterjesztés használatakor többször is megadható. (alapértelmezett: [".js", ".cjs", ".mjs", ".ts", ".mts", ".tsx", ".jsx", ".vue", ".svelte"]
).
coverage.clean
- CLI:
--coverage.clean
- Konfiguráció: coverage.clean
Lefedettségi eredmények törlése tesztelés előtt. (alapértelmezett: true
)
coverage.cleanOnRerun
- CLI:
--coverage.cleanOnRerun
- Konfiguráció: coverage.cleanOnRerun
Lefedettségi jelentés törlése figyelő módban történő újraindításkor. (alapértelmezett: true
)
coverage.reportsDirectory
- CLI:
--coverage.reportsDirectory <útvonal>
- Konfiguráció: coverage.reportsDirectory
A lefedettségi jelentés könyvtára. (alapértelmezett: ./coverage
)
coverage.reporter
- CLI:
--coverage.reporter <név>
- Konfiguráció: coverage.reporter
Használt lefedettségjelentés-típusok. További információért látogassa meg a coverage.reporter
oldalt. (alapértelmezett: ["text", "html", "clover", "json"]
).
coverage.reportOnFailure
- CLI:
--coverage.reportOnFailure
- Konfiguráció: coverage.reportOnFailure
Lefedettségi jelentés készítése sikertelen tesztek esetén is. (alapértelmezett: false
)
coverage.allowExternal
- CLI:
--coverage.allowExternal
- Konfiguráció: coverage.allowExternal
Projektgyökérön kívüli fájlok lefedettségének mérése. (alapértelmezett: false
)
coverage.skipFull
- CLI:
--coverage.skipFull
- Konfiguráció: coverage.skipFull
100%-os lefedettségű fájlok elrejtése. (alapértelmezett: false
)
coverage.thresholds.100
- CLI:
--coverage.thresholds.100
- Konfiguráció: coverage.thresholds.100
Gyorsbillentyű az összes lefedettségi küszöb 100-ra állításához. (alapértelmezett: false
)
coverage.thresholds.perFile
- CLI:
--coverage.thresholds.perFile
- Konfiguráció: coverage.thresholds.perFile
Fájlonkénti küszöbérték-ellenőrzés. Lásd a --coverage.thresholds.lines
, --coverage.thresholds.functions
, --coverage.thresholds.branches
és --coverage.thresholds.statements
opciókat a tényleges küszöbértékekhez. (alapértelmezett: false
)
coverage.thresholds.autoUpdate
- CLI:
--coverage.thresholds.autoUpdate
- Konfiguráció: coverage.thresholds.autoUpdate
Küszöbértékek frissítése: "lines", "functions", "branches" és "statements" a konfigurációs fájlba, ha az aktuális lefedettség meghaladja a konfigurált küszöbértékeket. (alapértelmezett: false
)
coverage.thresholds.lines
- CLI:
--coverage.thresholds.lines <szám>
Sorok lefedettségi küszöbértéke. További információért látogassa meg az istanbuljs oldalt. Ez az opció nem érhető el egyéni szolgáltatók számára.
coverage.thresholds.functions
- CLI:
--coverage.thresholds.functions <szám>
Függvények lefedettségi küszöbértéke. További információért látogassa meg az istanbuljs oldalt. Ez az opció nem érhető el egyéni szolgáltatók számára.
coverage.thresholds.branches
- CLI:
--coverage.thresholds.branches <szám>
Elágazások lefedettségi küszöbértéke. További információért látogassa meg az istanbuljs oldalt. Ez az opció nem érhető el egyéni szolgáltatók számára.
coverage.thresholds.statements
- CLI:
--coverage.thresholds.statements <szám>
Utasítások lefedettségi küszöbértéke. További információért látogassa meg az istanbuljs oldalt. Ez az opció nem érhető el egyéni szolgáltatók számára.
coverage.ignoreClassMethods
- CLI:
--coverage.ignoreClassMethods <név>
- Konfiguráció: coverage.ignoreClassMethods
Lefedettségmérésből kihagyott osztálymetódusok tömbje. További információért látogassa meg az istanbuljs oldalt. Ez az opció csak az istanbul szolgáltatók számára érhető el. (alapértelmezett: []
)
coverage.processingConcurrency
- CLI:
--coverage.processingConcurrency <szám>
- Konfiguráció: coverage.processingConcurrency
A lefedettségi eredmények feldolgozásakor használt párhuzamossági korlát. (alapértelmezett: a CPU-k számának és 20-nak a minimuma)
coverage.customProviderModule
- CLI:
--coverage.customProviderModule <útvonal>
- Konfiguráció: coverage.customProviderModule
Megadja az egyéni lefedettségi szolgáltató modul nevét vagy útvonalát. További információért látogassa meg az Egyéni lefedettségi szolgáltató oldalt. Ez az opció csak egyéni szolgáltatók számára érhető el.
coverage.watermarks.statements
- CLI:
--coverage.watermarks.statements <vízjelek>
Utasítások felső és alsó küszöbértékei <magas>,<alacsony>
formátumban.
coverage.watermarks.lines
- CLI:
--coverage.watermarks.lines <vízjelek>
Sorok felső és alsó küszöbértékei <magas>,<alacsony>
formátumban.
coverage.watermarks.branches
- CLI:
--coverage.watermarks.branches <vízjelek>
Elágazások felső és alsó küszöbértékei <magas>,<alacsony>
formátumban.
coverage.watermarks.functions
- CLI:
--coverage.watermarks.functions <vízjelek>
Függvények felső és alsó küszöbértékei <magas>,<alacsony>
formátumban.
mode
- CLI:
--mode <név>
- Konfiguráció: mode
A Vite mód felülírása. (alapértelmezett: test
vagy benchmark
)
workspace
- CLI:
--workspace <útvonal>
- Konfiguráció: workspace
[elavult] Útvonal egy munkaterület-konfigurációs fájlhoz.
isolate
- CLI:
--isolate
- Konfiguráció: isolate
Minden tesztfájl futtatása izolált környezetben. Az izoláció kikapcsolásához használja a --no-isolate
opciót. (alapértelmezett: true
)
globals
- CLI:
--globals
- Konfiguráció: globals
API-k globális injektálása.
dom
- CLI:
--dom
Böngésző API mockolása happy-dom-mal.
browser.enabled
- CLI:
--browser.enabled
- Konfiguráció: browser.enabled
Tesztfuttatás a böngészőben. Egyenértékű a --browser.enabled
opcióval. (alapértelmezett: false
)
browser.name
- CLI:
--browser.name <név>
- Konfiguráció: browser.name
Minden teszt futtatása egy adott böngészőben. Néhány böngésző csak bizonyos szolgáltatók számára érhető el (lásd --browser.provider
). További információért látogassa meg a browser.name
oldalt.
browser.headless
- CLI:
--browser.headless
- Konfiguráció: browser.headless
A böngésző futtatása fej nélküli módban (azaz a GUI (Grafikus Felhasználói Felület) megnyitása nélkül). Ha a Vitest-et CI-ben futtatja, alapértelmezés szerint engedélyezve lesz. (alapértelmezett: process.env.CI
)
browser.api.port
- CLI:
--browser.api.port [port]
- Konfiguráció: browser.api.port
A szerver portjának megadása. Megjegyzés: ha a port már foglalt, a Vite automatikusan megpróbálja a következő elérhető portot, így ez nem feltétlenül az a port lesz, amelyen a szerver végül figyel. Ha true
értékre van állítva, akkor 63315
lesz.
browser.api.host
- CLI:
--browser.api.host [host]
- Konfiguráció: browser.api.host
Adja meg, mely IP-címeken figyeljen a szerver. Állítsa 0.0.0.0
értékre vagy true
-ra, hogy minden címen figyeljen, beleértve a LAN és nyilvános címeket is.
browser.api.strictPort
- CLI:
--browser.api.strictPort
- Konfiguráció: browser.api.strictPort
Állítsa true
értékre, hogy kilépjen, ha a port már használatban van, ahelyett, hogy automatikusan megpróbálná a következő elérhető portot.
browser.provider
- CLI:
--browser.provider <név>
- Konfiguráció: browser.provider
A böngészőtesztek futtatásához használt szolgáltató. Néhány böngésző csak bizonyos szolgáltatók számára érhető el. Lehet "webdriverio", "playwright", "preview", vagy egy egyéni szolgáltató útvonala. További információért látogassa meg a browser.provider
oldalt. (alapértelmezett: "preview"
)
browser.providerOptions
- CLI:
--browser.providerOptions <opciók>
- Konfiguráció: browser.providerOptions
A böngésző szolgáltatónak átadott opciók. További információért látogassa meg a browser.providerOptions
oldalt.
browser.isolate
- CLI:
--browser.isolate
- Konfiguráció: browser.isolate
Minden böngésző tesztfájl futtatása izolált környezetben. Az izoláció kikapcsolásához használja a --browser.isolate=false
opciót. (alapértelmezett: true
)
browser.ui
- CLI:
--browser.ui
- Konfiguráció: browser.ui
Vitest UI megjelenítése tesztfuttatáskor. (alapértelmezett: !process.env.CI
)
browser.fileParallelism
- CLI:
--browser.fileParallelism
- Konfiguráció: browser.fileParallelism
Párhuzamosan fussanak-e a böngésző tesztfájlok. A kikapcsoláshoz használja a --browser.fileParallelism=false
opciót. (alapértelmezett: true
)
browser.connectTimeout
- CLI:
--browser.connectTimeout <időtúllépés>
- Konfiguráció: browser.connectTimeout
Ha a böngészőhöz való csatlakozás tovább tart, a tesztsorozat sikertelen lesz. (alapértelmezett: 60_000
)
pool
- CLI:
--pool <pool>
- Konfiguráció: pool
Adja meg a poolt, ha nem böngészőben fut. (alapértelmezett: forks
)
poolOptions.threads.isolate
- CLI:
--poolOptions.threads.isolate
- Konfiguráció: poolOptions.threads.isolate
Teszt izolálása szálak poolban. (alapértelmezett: true
)
poolOptions.threads.singleThread
- CLI:
--poolOptions.threads.singleThread
- Konfiguráció: poolOptions.threads.singleThread
Teszt futtatása egyetlen szálon belül. (alapértelmezett: false
)
poolOptions.threads.maxThreads
- CLI:
--poolOptions.threads.maxThreads <munkások>
- Konfiguráció: poolOptions.threads.maxThreads
Maximális számú vagy százalékos arányú szál, amelyben a teszteket futtatni kell.
poolOptions.threads.minThreads
- CLI:
--poolOptions.threads.minThreads <munkások>
- Konfiguráció: poolOptions.threads.minThreads
Minimális számú vagy százalékos arányú szál, amelyben a teszteket futtatni kell.
poolOptions.threads.useAtomics
- CLI:
--poolOptions.threads.useAtomics
- Konfiguráció: poolOptions.threads.useAtomics
Atomok használata a szálak szinkronizálásához. Ez bizonyos esetekben javíthatja a teljesítményt, de régebbi Node verziókban szegmentálási hibát okozhat. (alapértelmezett: false
)
poolOptions.vmThreads.isolate
- CLI:
--poolOptions.vmThreads.isolate
- Konfiguráció: poolOptions.vmThreads.isolate
Teszt izolálása szálak poolban. (alapértelmezett: true
)
poolOptions.vmThreads.singleThread
- CLI:
--poolOptions.vmThreads.singleThread
- Konfiguráció: poolOptions.vmThreads.singleThread
Teszt futtatása egyetlen szálon belül. (alapértelmezett: false
)
poolOptions.vmThreads.maxThreads
- CLI:
--poolOptions.vmThreads.maxThreads <munkások>
- Konfiguráció: poolOptions.vmThreads.maxThreads
Maximális számú vagy százalékos arányú szál, amelyben a teszteket futtatni kell.
poolOptions.vmThreads.minThreads
- CLI:
--poolOptions.vmThreads.minThreads <munkások>
- Konfiguráció: poolOptions.vmThreads.minThreads
Minimális számú vagy százalékos arányú szál, amelyben a teszteket futtatni kell.
poolOptions.vmThreads.useAtomics
- CLI:
--poolOptions.vmThreads.useAtomics
- Konfiguráció: poolOptions.vmThreads.useAtomics
Atomok használata a szálak szinkronizálásához. Ez bizonyos esetekben javíthatja a teljesítményt, de régebbi Node verziókban szegmentálási hibát okozhat. (alapértelmezett: false
)
poolOptions.vmThreads.memoryLimit
- CLI:
--poolOptions.vmThreads.memoryLimit <limit>
- Konfiguráció: poolOptions.vmThreads.memoryLimit
Memórialimit a VM szálak poolhoz. Ha memóriaszivárgást tapasztal, próbálja meg módosítani ezt az értéket.
poolOptions.forks.isolate
- CLI:
--poolOptions.forks.isolate
- Konfiguráció: poolOptions.forks.isolate
Teszt izolálása forkok poolban. (alapértelmezett: true
)
poolOptions.forks.singleFork
- CLI:
--poolOptions.forks.singleFork
- Konfiguráció: poolOptions.forks.singleFork
Teszt futtatása egyetlen child_process-en belül. (alapértelmezett: false
)
poolOptions.forks.maxForks
- CLI:
--poolOptions.forks.maxForks <munkások>
- Konfiguráció: poolOptions.forks.maxForks
Maximális számú vagy százalékos arányú folyamat, amelyben a teszteket futtatni kell.
poolOptions.forks.minForks
- CLI:
--poolOptions.forks.minForks <munkások>
- Konfiguráció: poolOptions.forks.minForks
Minimális számú vagy százalékos arányú folyamat, amelyben a teszteket futtatni kell.
poolOptions.vmForks.isolate
- CLI:
--poolOptions.vmForks.isolate
- Konfiguráció: poolOptions.vmForks.isolate
Teszt izolálása forkok poolban. (alapértelmezett: true
)
poolOptions.vmForks.singleFork
- CLI:
--poolOptions.vmForks.singleFork
- Konfiguráció: poolOptions.vmForks.singleFork
Teszt futtatása egyetlen child_process-en belül. (alapértelmezett: false
)
poolOptions.vmForks.maxForks
- CLI:
--poolOptions.vmForks.maxForks <munkások>
- Konfiguráció: poolOptions.vmForks.maxForks
Maximális számú vagy százalékos arányú folyamat, amelyben a teszteket futtatni kell.
poolOptions.vmForks.minForks
- CLI:
--poolOptions.vmForks.minForks <munkások>
- Konfiguráció: poolOptions.vmForks.minForks
Minimális számú vagy százalékos arányú folyamat, amelyben a teszteket futtatni kell.
poolOptions.vmForks.memoryLimit
- CLI:
--poolOptions.vmForks.memoryLimit <limit>
- Konfiguráció: poolOptions.vmForks.memoryLimit
Memórialimit a VM forkok poolhoz. Ha memóriaszivárgást tapasztal, próbálja meg módosítani ezt az értéket.
fileParallelism
- CLI:
--fileParallelism
- Konfiguráció: fileParallelism
Párhuzamosan fussanak-e az összes tesztfájl. A kikapcsoláshoz használja a --no-file-parallelism
opciót. (alapértelmezett: true
)
maxWorkers
- CLI:
--maxWorkers <munkások>
- Konfiguráció: maxWorkers
Maximális számú vagy százalékos arányú munkás, amelyben a teszteket futtatni kell.
minWorkers
- CLI:
--minWorkers <munkások>
- Konfiguráció: minWorkers
Minimális számú vagy százalékos arányú munkás, amelyben a teszteket futtatni kell.
environment
- CLI:
--environment <név>
- Konfiguráció: environment
Futtató környezet megadása, ha nem böngészőben fut. (alapértelmezett: node
)
passWithNoTests
- CLI:
--passWithNoTests
- Konfiguráció: passWithNoTests
Sikeres, ha nem található teszt.
logHeapUsage
- CLI:
--logHeapUsage
- Konfiguráció: logHeapUsage
A heap méretének megjelenítése minden teszthez, amikor Node.js környezetben fut.
allowOnly
- CLI:
--allowOnly
- Konfiguráció: allowOnly
Csak az "only" jelöléssel ellátott tesztek és tesztsorozatok engedélyezése. (alapértelmezett: !process.env.CI
)
dangerouslyIgnoreUnhandledErrors
- CLI:
--dangerouslyIgnoreUnhandledErrors
- Konfiguráció: dangerouslyIgnoreUnhandledErrors
Minden kezeletlen hiba figyelmen kívül hagyása.
sequence.shuffle.files
- CLI:
--sequence.shuffle.files
- Konfiguráció: sequence.shuffle.files
Fájlok futtatása véletlenszerű sorrendben. A hosszan futó tesztek nem indulnak el korábban, ha engedélyezi ezt az opciót. (alapértelmezett: false
)
sequence.shuffle.tests
- CLI:
--sequence.shuffle.tests
- Konfiguráció: sequence.shuffle.tests
Tesztfuttatás véletlenszerű sorrendben. (alapértelmezett: false
)
sequence.concurrent
- CLI:
--sequence.concurrent
- Konfiguráció: sequence.concurrent
Tesztfuttatás párhuzamosan. (alapértelmezett: false
)
sequence.seed
- CLI:
--sequence.seed <seed>
- Konfiguráció: sequence.seed
A randomizálási mag beállítása. Ez az opció nem lesz hatással, ha a --sequence.shuffle
hamis. További információért látogassa meg a "Random Seed" oldalt.
sequence.hooks
- CLI:
--sequence.hooks <sorrend>
- Konfiguráció: sequence.hooks
Megváltoztatja a hookok végrehajtási sorrendjét. Elfogadott értékek: "stack", "list" és "parallel". További információért látogassa meg a sequence.hooks
oldalt. (alapértelmezett: "parallel"
)
sequence.setupFiles
- CLI:
--sequence.setupFiles <sorrend>
- Konfiguráció: sequence.setupFiles
Megváltoztatja a beállítási fájlok végrehajtási sorrendjét. Elfogadott értékek: "list" és "parallel". Ha "list"-re van állítva, a beállítási fájlokat a definiálásuk sorrendjében futtatja. Ha "parallel"-re van állítva, a beállítási fájlokat párhuzamosan futtatja. (alapértelmezett: "parallel"
)
inspect
- CLI:
--inspect [[host:]port]
- Konfiguráció: inspect
Node.js inspector engedélyezése. (alapértelmezett: 127.0.0.1:9229
)
inspectBrk
- CLI:
--inspectBrk [[host:]port]
- Konfiguráció: inspectBrk
Node.js inspector engedélyezése és megszakítás a teszt indítása előtt.
testTimeout
- CLI:
--testTimeout <időtúllépés>
- Konfiguráció: testTimeout
Egy teszt alapértelmezett időtúllépése milliszekundumban. (alapértelmezett: 5000
). Használja a 0
értéket az időtúllépés teljes kikapcsolásához.
hookTimeout
- CLI:
--hookTimeout <időtúllépés>
- Konfiguráció: hookTimeout
Alapértelmezett hook időtúllépés milliszekundumban. (alapértelmezett: 10000
). Használja a 0
értéket az időtúllépés teljes kikapcsolásához.
bail
- CLI:
--bail <szám>
- Konfiguráció: bail
Teszt végrehajtásának leállítása, ha a megadott számú teszt sikertelen. (alapértelmezett: 0
)
retry
- CLI:
--retry <alkalom>
- Konfiguráció: retry
A teszt újrapróbálása a megadott számú alkalommal, ha sikertelen. (alapértelmezett: 0
)
diff.aAnnotation
- CLI:
--diff.aAnnotation <annotáció>
- Konfiguráció: diff.aAnnotation
Annotáció a várt sorokhoz. (alapértelmezett: Expected
)
diff.aIndicator
- CLI:
--diff.aIndicator <indikátor>
- Konfiguráció: diff.aIndicator
Indikátor a várt sorokhoz. (alapértelmezett: -
)
diff.bAnnotation
- CLI:
--diff.bAnnotation <annotáció>
- Konfiguráció: diff.bAnnotation
Annotáció a kapott sorokhoz. (alapértelmezett: Received
)
diff.bIndicator
- CLI:
--diff.bIndicator <indikátor>
- Konfiguráció: diff.bIndicator
Indikátor a kapott sorokhoz. (alapértelmezett: +
)
diff.commonIndicator
- CLI:
--diff.commonIndicator <indikátor>
- Konfiguráció: diff.commonIndicator
Indikátor a közös sorokhoz. (alapértelmezett: )
diff.contextLines
- CLI:
--diff.contextLines <sorok>
- Konfiguráció: diff.contextLines
A változások körüli kontextus sorainak száma. (alapértelmezett: 5
)
diff.emptyFirstOrLastLinePlaceholder
- CLI:
--diff.emptyFirstOrLastLinePlaceholder <helyőrző>
- Konfiguráció: diff.emptyFirstOrLastLinePlaceholder
Helyőrző egy üres első vagy utolsó sorhoz. (alapértelmezett: ""
)
diff.expand
- CLI:
--diff.expand
- Konfiguráció: diff.expand
Az összes közös sor kibontása. (alapértelmezett: true
)
diff.includeChangeCounts
- CLI:
--diff.includeChangeCounts
- Konfiguráció: diff.includeChangeCounts
Összehasonlítási számok belefoglalása a diff kimenetbe. (alapértelmezett: false
)
diff.omitAnnotationLines
- CLI:
--diff.omitAnnotationLines
- Konfiguráció: diff.omitAnnotationLines
Annotációs sorok kihagyása a kimenetből. (alapértelmezett: false
)
diff.printBasicPrototype
- CLI:
--diff.printBasicPrototype
- Konfiguráció: diff.printBasicPrototype
Alapvető prototípus objektum és tömb nyomtatása. (alapértelmezett: true
)
diff.maxDepth
- CLI:
--diff.maxDepth <maxDepth>
- Konfiguráció: diff.maxDepth
A beágyazott objektumok nyomtatásakor a rekurzió mélységének korlátozása. (alapértelmezett: 20
)
diff.truncateThreshold
- CLI:
--diff.truncateThreshold <küszöb>
- Konfiguráció: diff.truncateThreshold
A változások előtt és után megjelenítendő sorok száma. (alapértelmezett: 0
)
diff.truncateAnnotation
- CLI:
--diff.truncateAnnotation <annotáció>
- Konfiguráció: diff.truncateAnnotation
Annotáció a csonkolt sorokhoz. (alapértelmezett: ... Diff result is truncated
)
exclude
- CLI:
--exclude <glob>
- Konfiguráció: exclude
További fájl glob minták, amelyeket ki kell zárni a tesztből.
expandSnapshotDiff
- CLI:
--expandSnapshotDiff
- Konfiguráció: expandSnapshotDiff
Teljes diff megjelenítése, ha a pillanatkép sikertelen.
disableConsoleIntercept
- CLI:
--disableConsoleIntercept
- Konfiguráció: disableConsoleIntercept
A konzolnaplózás automatikus elfogásának letiltása. (alapértelmezett: false
)
typecheck.enabled
- CLI:
--typecheck.enabled
- Konfiguráció: typecheck.enabled
Típusellenőrzés engedélyezése a tesztek mellett. (alapértelmezett: false
)
typecheck.only
- CLI:
--typecheck.only
- Konfiguráció: typecheck.only
Csak típusellenőrzési tesztek futtatása. Ez automatikusan engedélyezi a típusellenőrzést. (alapértelmezett: false
)
typecheck.checker
- CLI:
--typecheck.checker <név>
- Konfiguráció: typecheck.checker
Adja meg a használandó típusellenőrzőt. Elérhető értékek: "tsc" és "vue-tsc", valamint egy futtatható fájl útvonala. (alapértelmezett: "tsc"
)
typecheck.allowJs
- CLI:
--typecheck.allowJs
- Konfiguráció: typecheck.allowJs
JavaScript fájlok típusellenőrzésének engedélyezése. Alapértelmezés szerint a tsconfig.json
értékét veszi fel.
typecheck.ignoreSourceErrors
- CLI:
--typecheck.ignoreSourceErrors
- Konfiguráció: typecheck.ignoreSourceErrors
Típushibák figyelmen kívül hagyása a forrásfájlokból.
typecheck.tsconfig
- CLI:
--typecheck.tsconfig <útvonal>
- Konfiguráció: typecheck.tsconfig
Útvonal egy egyéni tsconfig
fájlhoz.
typecheck.spawnTimeout
- CLI:
--typecheck.spawnTimeout <idő>
- Konfiguráció: typecheck.spawnTimeout
Minimális idő milliszekundumban, amíg a típusellenőrző elindul.
project
- CLI:
--project <név>
- Konfiguráció: project
A futtatandó projekt neve, ha a Vitest munkaterület funkciót használ. Ez többször is megismételhető több projekthez: --project=1 --project=2
. Projektek szűrhetők helyettesítő karakterekkel is, mint például --project=packages*
, és kizárhatók projektek a --project=!pattern
segítségével.
slowTestThreshold
- CLI:
--slowTestThreshold <küszöb>
- Konfiguráció: slowTestThreshold
Küszöb milliszekundumban, amely felett egy teszt vagy tesztsorozat lassúnak minősül. (alapértelmezett: 300
)
teardownTimeout
- CLI:
--teardownTimeout <időtúllépés>
- Konfiguráció: teardownTimeout
Egy teardown függvény alapértelmezett időtúllépése milliszekundumban. (alapértelmezett: 10000
)
maxConcurrency
- CLI:
--maxConcurrency <szám>
- Konfiguráció: maxConcurrency
Maximális számú párhuzamos teszt egy tesztsorozatban. (alapértelmezett: 5
)
expect.requireAssertions
- CLI:
--expect.requireAssertions
- Konfiguráció: expect.requireAssertions
Megköveteli, hogy minden tesztnek legyen legalább egy állítása.
expect.poll.interval
- CLI:
--expect.poll.interval <intervallum>
- Konfiguráció: expect.poll.interval
Lekérdezési intervallum milliszekundumban az expect.poll()
állításokhoz. (alapértelmezett: 50
)
expect.poll.timeout
- CLI:
--expect.poll.timeout <időtúllépés>
- Konfiguráció: expect.poll.timeout
Lekérdezési időtúllépés milliszekundumban az expect.poll()
állításokhoz. (alapértelmezett: 1000
)
printConsoleTrace
- CLI:
--printConsoleTrace
- Konfiguráció: printConsoleTrace
Mindig nyomtassa ki a konzol stack trace-eket.
includeTaskLocation
- CLI:
--includeTaskLocation
- Konfiguráció: includeTaskLocation
Teszt- és tesztsorozat-helyek gyűjtése a location
tulajdonságban.
attachmentsDir
- CLI:
--attachmentsDir <könyvtár>
- Konfiguráció: attachmentsDir
A könyvtár, ahová a context.annotate
mellékletei kerülnek. (alapértelmezett: .vitest-attachments
)
run
- CLI:
--run
Figyelő mód letiltása.
color
- CLI:
--no-color
Eltávolítja a színeket a konzolkimenetből.
clearScreen
- CLI:
--clearScreen
Terminál képernyőjének törlése a tesztek újrafuttatásakor figyelő módban. (alapértelmezett: true
)
configLoader
- CLI:
--configLoader <betöltő>
Használja a bundle
opciót a konfiguráció esbuild-del történő kötegeléséhez, vagy a runner
(kísérleti) opciót a futás közbeni feldolgozáshoz. Ez csak a Vite 6.1.0-s és újabb verzióiban érhető el. (alapértelmezett: bundle
)
standalone
- CLI:
--standalone
Vitest indítása tesztek futtatása nélkül. A fájlszűrők figyelmen kívül maradnak, a tesztek csak változás esetén futnak. (alapértelmezett: false
)
changed
- Típus:
boolean | string
- Alapértelmezett: false
Csak a megváltozott fájlok esetén futtatja a teszteket. Ha nincs megadva érték, akkor a nem commitált változásokon (beleértve a szakaszolt és nem szakaszolt módosításokat) futtatja a teszteket.
Az utolsó commitban történt változásokon való teszteléshez használhatja a --changed HEAD~1
parancsot. Commit hash-t (pl. --changed 09a9920
) vagy ág nevét (pl. --changed origin/develop
) is átadhatja.
Kódlefedettséggel együtt használva a jelentés csak a változásokhoz kapcsolódó fájlokat tartalmazza.
Ha a forceRerunTriggers
konfigurációs opcióval együtt használják, akkor a teljes tesztcsomagot futtatja, amennyiben a forceRerunTriggers
listában szereplő fájlok közül legalább egy megváltozik. Alapértelmezés szerint a Vitest konfigurációs fájl és a package.json
módosításai mindig újra futtatják a teljes tesztcsomagot.
shard
- Típus:
string
- Alapértelmezett: disabled
A végrehajtandó tesztcsomag felosztása (shard) <index>
/<count>
formátumban, ahol
count
egy pozitív egész szám, az osztott részek darabszámaindex
egy pozitív egész szám, az osztott rész sorszáma
Ez a parancs az összes tesztet count
egyenlő részre osztja, és csak azokat futtatja, amelyek az index
sorszámú részbe esnek. Például, ha a tesztcsomagot három részre szeretné osztani, használja ezt:
vitest run --shard=1/3
vitest run --shard=2/3
vitest run --shard=3/3
WARNING
Ezt az opciót nem használhatja a --watch
engedélyezett állapotában (fejlesztésben alapértelmezés szerint engedélyezve van).
TIP
Ha a --reporter=blob
kimeneti fájl megadása nélkül kerül felhasználásra, az alapértelmezett útvonal tartalmazni fogja az aktuális shard konfigurációt, hogy elkerülje az ütközéseket más Vitest folyamatokkal.
merge-reports
- Típus:
boolean | string
Összevonja az összes blob jelentést a megadott mappában (alapértelmezés szerint .vitest-reports
). Ezzel a paranccsal bármilyen riportert/jelentéskészítőt használhat (kivéve a blob
riportert):
vitest --merge-reports --reporter=junit