Parancssori interfész
Parancsok
vitest
Elindítja a Vitest tesztfuttatót az aktuális könyvtárban. Fejlesztői környezetben automatikusan figyelő (watch) módba kapcsol, CI (folyamatos integrációs) környezetben pedig egyszeri futtatási módba.
További argumentumként megadható a futtatandó tesztfájlok szűrője. Például:
vitest foobar
Ez a parancs csak azokat a tesztfájlokat futtatja, amelyek elérési útvonala tartalmazza a foobar
szót. Ez a szűrő egyszerű szöveges egyezést ellenőriz, és nem támogatja a reguláris kifejezéseket vagy globális mintákat (kivéve, ha a terminálja feldolgozza azt, mielőtt a Vitest megkapja a szűrőt).
vitest run
Egyszeri futtatást végez figyelő mód nélkül. A tesztek lefutása után a folyamat kilép.
vitest watch
Lefuttatja az összes tesztcsomagot, majd figyeli a fájlváltozásokat, és újra futtatja a releváns teszteket, ha azok megváltoznak. Ugyanazt a viselkedést eredményezi, mint amikor a vitest
parancsot argumentum nélkül hívják meg. CI környezetben átvált a vitest run
parancsra.
vitest dev
A vitest watch
parancs aliasa.
vitest related
Csak azokat a teszteket futtatja, amelyek egy megadott listában szereplő forrásfájlokat fednek le. Statikus importokkal (például import './index.js'
vagy import index from './index.js'
) működik, de dinamikus importokkal (például import(filepath)
) nem. Minden fájlnak a gyökérkönyvtárhoz képest relatív útvonallal kell rendelkeznie.
Hasznos a lint-staged
vagy a CI beállításokkal együtt használni.
vitest related /src/index.ts /src/hello-world.js
TIP
Ne feledje, hogy a Vitest alapértelmezés szerint engedélyezett 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 kiléphessen a tesztek befejezése után.
// .lintstagedrc.js
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 <név>
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 elfogadja az összes vitest
opciót az összes egyező teszt listájának kiírásához. Ez a parancs nem veszi figyelembe a reporters
opciót. Alapértelmezés szerint kiírja az összes olyan teszt nevét, amely illeszkedik a fájlszűrőhöz és a névmintához:
vitest list filename.spec.ts -t="some-test"
describe > some-test
describe > some-test > test 1
describe > some-test > test 2
Átadhatja a --json
jelzőt a tesztek JSON formátumban történő kiírásához, vagy egy külön fájlba mentéséhez:
vitest list filename.spec.ts -t="some-test" --json=./file.json
Ha a --json
jelző nem kap értéket, akkor a JSON-t a standard kimenetre (stdout) írja.
Átadhatja a --filesOnly
jelző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 camel case és a kebab case formátumot is a CLI argumentumok esetében. 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 átadni:
vitest --reporter=dot --reporter=default
A logikai opciók no-
előtaggal megtagadhatók. Az érték false
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
Tesztpillanatkép frissítése.
watch
- CLI:
-w, --watch
- Konfiguráció: watch
Figyelő mód engedélyezése.
testNamePattern
- CLI:
-t, --testNamePattern <minta>
- Konfiguráció: testNamePattern
Tesztek futtatása a megadott reguláris kifejezés mintájának megfelelő nevekkel.
dir
- CLI:
--dir <útvonal>
- Konfiguráció: dir
Kiindulási könyvtár a tesztfájlok kereséséhez.
ui
- CLI:
--ui
- Konfiguráció: ui
A felhasználói felület (UI) engedélyezése.
open
- CLI:
--open
- Konfiguráció: open
A felhasználói felület (UI) automatikus megnyitása (alapértelmezett: !process.env.CI
).
api.port
- CLI:
--api.port [port]
A szerver portjának megadása. Fontos: 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, amin a szerver végül figyel. Ha a port paraméter értéke true
, akkor 51204
lesz.
api.host
- CLI:
--api.host [host]
Adja meg, mely IP-címeken hallgasson a szerver. Állítsa 0.0.0.0
-ra vagy true
-ra, hogy minden címen hallgasson, beleértve a LAN és nyilvános címeket is.
api.strictPort
- CLI:
--api.strictPort
Ha true
értékre állítja, a program kilép, ha a port már használatban van, ahelyett, hogy automatikusan megpróbálná a következő elérhető portot.
silent
- CLI:
--silent
- Konfiguráció: silent
A tesztek konzolkimenetének elnémítása.
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.
outputFile
- CLI:
--outputFile <fájlnév/-ek>
- Konfiguráció: outputFile
Teszt eredmények fájlba írása, ha meg van adva támogatott jelentéskészítő. Több jelentéskészítő egyedi kimeneteihez használja a cac pontjelölését (például: --outputFile.tap=./tap.txt
).
coverage.all
- CLI:
--coverage.all
- Konfiguráció: coverage.all
Tartalmazza-e a jelentés az összes fájlt, beleértve a teszteletleneket is.
coverage.provider
- CLI:
--coverage.provider <név>
- Konfiguráció: coverage.provider
Válassza ki a lefedettségméréshez használt eszközt. Elérhető értékek: "v8", "istanbul" és "custom".
coverage.enabled
- CLI:
--coverage.enabled
- Konfiguráció: coverage.enabled
Engedélyezi a lefedettségmérést. Felülírható a --coverage
CLI opcióval (alapértelmezett: false
).
coverage.include
- CLI:
--coverage.include <minta>
- Konfiguráció: coverage.include
A lefedettségmérésbe glob mintaként belefoglalt fájlok. Több minta használatakor többször is megadható (alapértelmezett: **
).
coverage.exclude
- CLI:
--coverage.exclude <minta>
- Konfiguráció: coverage.exclude
A lefedettségből kizárandó fájlok. Több minta használatakor többször is megadható (alapértelmezett: Lásd coverage.exclude
).
coverage.extension
- CLI:
--coverage.extension <kiterjesztés>
- Konfiguráció: coverage.extension
A lefedettségbe bevonandó fájlkiterjesztések. 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 adatok törlése a tesztek futtatása előtt (alapértelmezett: true
).
coverage.cleanOnRerun
- CLI:
--coverage.cleanOnRerun
- Konfiguráció: coverage.cleanOnRerun
Lefedettségi jelentés törlése újrafuttatáskor, figyelő módban (alapértelmezett: true
).
coverage.reportsDirectory
- CLI:
--coverage.reportsDirectory <útvonal>
- Konfiguráció: coverage.reportsDirectory
A lefedettségi jelentés mentési könyvtára (alapértelmezett: ./coverage
).
coverage.reporter
- CLI:
--coverage.reporter <név>
- Konfiguráció: coverage.reporter
Használandó lefedettségi jelentéskészítők. További információkért lásd coverage.reporter
(alapértelmezett: ["text", "html", "clover", "json"]
).
coverage.reportOnFailure
- CLI:
--coverage.reportOnFailure
- Konfiguráció: coverage.reportOnFailure
Lefedettségi jelentés generálása akkor is, ha a tesztek sikertelenek (alapértelmezett: false
).
coverage.allowExternal
- CLI:
--coverage.allowExternal
- Konfiguráció: coverage.allowExternal
A projekt gyökérkönyvtárán kívüli fájlok lefedettségének gyűjtése (alapértelmezett: false
).
coverage.skipFull
- CLI:
--coverage.skipFull
- Konfiguráció: coverage.skipFull
Ne jelenítse meg azokat a fájlokat, amelyek 100%-os utasítás-, elágazás- és függvénylefedettséggel rendelkeznek (alapértelmezett: false
).
coverage.thresholds.100
- CLI:
--coverage.thresholds.100
- Konfiguráció: coverage.thresholds.100
Rövidítés 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
Küszöbértékek ellenőrzése fájlonként. A tényleges küszöbértékekért lásd a --coverage.thresholds.lines
, --coverage.thresholds.functions
, --coverage.thresholds.branches
és --coverage.thresholds.statements
opciókat (alapértelmezett: false
).
coverage.thresholds.autoUpdate
- CLI:
--coverage.thresholds.autoUpdate
- Konfiguráció: coverage.thresholds.autoUpdate
A "lines", "functions", "branches" és "statements" küszöbértékek frissítése a konfigurációs fájlban, 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>
Küszöbérték a sorokhoz. További információkért lásd 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>
Küszöbérték a függvényekhez. További információkért lásd 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>
Küszöbérték az elágazásokhoz. További információkért lásd 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>
Küszöbérték az utasításokhoz. További információkért lásd 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
Osztálymetódusnevek tömbje, amelyek figyelmen kívül hagyandók a lefedettség szempontjából. További információkért lásd 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 20 és a CPU-k száma közül a kisebbik).
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ókért lásd 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>
Magas és alacsony határértékek az utasításokhoz <magas>,<alacsony>
formátumban.
coverage.watermarks.lines
- CLI:
--coverage.watermarks.lines <vízjelek>
Magas és alacsony határértékek a sorokhoz <magas>,<alacsony>
formátumban.
coverage.watermarks.branches
- CLI:
--coverage.watermarks.branches <vízjelek>
Magas és alacsony határértékek az elágazásokhoz <magas>,<alacsony>
formátumban.
coverage.watermarks.functions
- CLI:
--coverage.watermarks.functions <vízjelek>
Magas és alacsony határértékek a függvényekhez <magas>,<alacsony>
formátumban.
mode
- CLI:
--mode <név>
- Konfiguráció: mode
Vite mód felülbírálása (alapértelmezett: test
vagy benchmark
).
workspace
- CLI:
--workspace <útvonal>
- Konfiguráció: workspace
Munkaterület konfigurációs fájl útvonala.
isolate
- CLI:
--isolate
- Konfiguráció: isolate
Minden tesztfájl futtatása izoláltan. 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
Az összes 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ókért lásd browser.name
.
browser.headless
- CLI:
--browser.headless
- Konfiguráció: browser.headless
A böngésző futtatása fej nélküli módban (azaz grafikus felhasználói felület 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. Fontos: 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, amin a szerver végül figyel. Ha a port paraméter értéke true
, akkor 63315
lesz.
browser.api.host
- CLI:
--browser.api.host [host]
- Konfiguráció: browser.api.host
Adja meg, mely IP-címeken hallgasson a szerver. Állítsa 0.0.0.0
-ra vagy true
-ra, hogy minden címen hallgasson, beleértve a LAN és nyilvános címeket is.
browser.api.strictPort
- CLI:
--browser.api.strictPort
- Konfiguráció: browser.api.strictPort
Ha true
értékre állítja, a program kilép, 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ókért lásd browser.provider
(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ókért lásd browser.providerOptions
.
browser.isolate
- CLI:
--browser.isolate
- Konfiguráció: browser.isolate
Minden böngésző tesztfájl futtatása izoláltan. 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
).
pool
- CLI:
--pool <pool>
- Konfiguráció: pool
Adja meg a poolt, ha nem böngészőben fut (alapértelmezett: threads
).
poolOptions.threads.isolate
- CLI:
--poolOptions.threads.isolate
- Konfiguráció: poolOptions.threads.isolate
Tesztfuttatás izoláltan a szálak poolban (alapértelmezett: true
).
poolOptions.threads.singleThread
- CLI:
--poolOptions.threads.singleThread
- Konfiguráció: poolOptions.threads.singleThread
Tesztfuttatás 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 a tesztek futtatásához.
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 a tesztek futtatásához.
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
Tesztfuttatás izoláltan a VM szálak poolban (alapértelmezett: true
).
poolOptions.vmThreads.singleThread
- CLI:
--poolOptions.vmThreads.singleThread
- Konfiguráció: poolOptions.vmThreads.singleThread
Tesztfuttatás egyetlen VM 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ú VM szál a tesztek futtatásához.
poolOptions.vmThreads.minThreads
- CLI:
--poolOptions.vmThreads.minThreads <munkások>
- Konfiguráció: poolOptions.vmThreads.minThreads
Minimális számú vagy százalékos arányú VM szál a tesztek futtatásához.
poolOptions.vmThreads.useAtomics
- CLI:
--poolOptions.vmThreads.useAtomics
- Konfiguráció: poolOptions.vmThreads.useAtomics
Atomok használata a VM 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 <korlát>
- 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
Tesztfuttatás izoláltan a forkok poolban (alapértelmezett: true
).
poolOptions.forks.singleFork
- CLI:
--poolOptions.forks.singleFork
- Konfiguráció: poolOptions.forks.singleFork
Tesztfuttatás 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 a tesztek futtatásához.
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 a tesztek futtatásához.
poolOptions.vmForks.isolate
- CLI:
--poolOptions.vmForks.isolate
- Konfiguráció: poolOptions.vmForks.isolate
Tesztfuttatás izoláltan a VM forkok poolban (alapértelmezett: true
).
poolOptions.vmForks.singleFork
- CLI:
--poolOptions.vmForks.singleFork
- Konfiguráció: poolOptions.vmForks.singleFork
Tesztfuttatás egyetlen VM 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ú VM folyamat a tesztek futtatásához.
poolOptions.vmForks.minForks
- CLI:
--poolOptions.vmForks.minForks <munkások>
- Konfiguráció: poolOptions.vmForks.minForks
Minimális számú vagy százalékos arányú VM folyamat a tesztek futtatásához.
poolOptions.vmForks.memoryLimit
- CLI:
--poolOptions.vmForks.memoryLimit <korlát>
- 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 a tesztek futtatásához.
minWorkers
- CLI:
--minWorkers <munkások>
- Konfiguráció: minWorkers
Minimális számú vagy százalékos arányú munkás a tesztek futtatásához.
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
A teszt sikeresnek minősül, ha nem található teszt.
logHeapUsage
- CLI:
--logHeapUsage
- Konfiguráció: logHeapUsage
A heap méretének megjelenítése minden teszthez, ha Node.js környezetben fut.
allowOnly
- CLI:
--allowOnly
- Konfiguráció: allowOnly
Csak az "only" jelöléssel ellátott tesztek és tesztcsomagok 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 hosszú ideig 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 <mag>
- Konfiguráció: sequence.seed
A véletlenszerűsítési mag beállítása. Ez az opció nem lesz hatással, ha a --sequence.shuffle
hamis. További információkért lásd a "Véletlenszerű mag" 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ókért lásd sequence.hooks
(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
).
hookTimeout
- CLI:
--hookTimeout <időtúllépés>
- Konfiguráció: hookTimeout
Alapértelmezett hook időtúllépés milliszekundumban (alapértelmezett: 10000
).
bail
- CLI:
--bail <szám>
- Konfiguráció: bail
Tesztfuttatás leállítása, ha a megadott számú teszt sikertelen (alapértelmezett: 0
).
retry
- CLI:
--retry <alkalom>
- Konfiguráció: retry
A teszt újrafuttatása a megadott számú alkalommal, ha sikertelen (alapértelmezett: 0
).
diff
- CLI:
--diff <útvonal>
- Konfiguráció: diff
Útvonal egy diff konfigurációhoz, amelyet a diff felület generálásához használnak.
exclude
- CLI:
--exclude <glob>
- Konfiguráció: exclude
További fájlminták (glob), 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
Egyéni tsconfig fájl útvonala.
project
- CLI:
--project <név>
- Konfiguráció: project
A futtatandó projekt neve, ha a Vitest munkaterület funkcióját használja. 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*
.
slowTestThreshold
- CLI:
--slowTestThreshold <küszöb>
- Konfiguráció: slowTestThreshold
Küszöb milliszekundumban, amely felett egy teszt 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 tesztcsomagban (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 veremkövetéseit.
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
).
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ájlokon futtatja a teszteket. Ha nincs megadva érték, akkor a nem véglegesített változásokon (beleértve az előkészített és nem előkészített változásokat is) futtatja a teszteket.
Az utolsó commitban történt változásokon futtatott tesztekhez 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ásokkal érintett fájlokat fogja tartalmazni.
Ha a forceRerunTriggers
konfigurációs opcióval együtt használják, akkor a teljes tesztcsomagot lefuttatja, ha 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
változásai mindig újra futtatják a teljes csomagot.
shard
- Típus:
string
- Alapértelmezett: disabled
Tesztcsomag felosztás (shard), amelyet <index>
/<count>
formátumban kell megadni, ahol:
count
egy pozitív egész szám, az osztott részek teljes számaindex
egy pozitív egész szám, az aktuális osztott rész indexe (1-tőlcount
-ig)
Ez a parancs az összes tesztet count
egyenlő részre osztja, és csak azokat futtatja, amelyek az index
részhez tartoznak. 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ői környezetben alapértelmezés szerint engedélyezve van).
TIP
Ha a --reporter=blob
opciót kimeneti fájl nélkül használja, 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 riportot használhat (kivéve a blob
riportot):
vitest --merge-reports --reporter=junit