Komut Satırı Arayüzü
Komutlar
vitest
Vitest'i mevcut dizinde başlatır. Geliştirme ortamında otomatik olarak izleme moduna geçerken, CI ortamında çalıştırma modunda çalışır.
Çalıştırılacak test dosyalarını filtrelemek için ek bir argüman geçirebilirsiniz. Örneğin:
vitest foobar
Bu komut, yollarında foobar
içeren test dosyalarını çalıştıracaktır. Bu filtre yalnızca metin içerme durumunu kontrol eder; düzenli ifadeleri veya glob desenlerini desteklemez (terminaliniz filtreyi Vitest'e göndermeden önce işlemediği sürece).
vitest run
İzleme modu olmadan tek bir test çalıştırması gerçekleştirir.
vitest watch
Tüm test suitlerini çalıştırır, ancak dosya değişikliklerini izler ve değişen testleri otomatik olarak yeniden çalıştırır. Argüman olmadan vitest
komutunu çağırmakla aynı işlevi görür. CI ortamında vitest run
moduna geçer.
vitest dev
vitest watch
komutunun kısaltmasıdır.
vitest related
Yalnızca belirli kaynak dosyalarını etkileyen testleri çalıştırır. Statik importlarla (örn. import('./index.js')
veya import index from './index.js
) uyumlu çalışır, ancak dinamik importlarla (örn. import(filepath)
) çalışmaz. Tüm dosya yolları kök klasöre göre belirtilmelidir.
Bu komut, lint-staged
veya CI kurulumunuzla birlikte kullanışlıdır.
vitest related /src/index.ts /src/hello-world.js
::: ipucu Vitest'in varsayılan olarak izleme modunda çalıştığını unutmayın. lint-staged
gibi araçlar kullanıyorsanız, komutun sorunsuz bir şekilde sonlanabilmesi için --run
seçeneğini de eklemelisiniz.
// .lintstagedrc.js
export default {
'*.{js,ts}': 'vitest related --run',
};
:::
vitest bench
Yalnızca performans sonuçlarını kıyaslayan benchmark testlerini çalıştırır.
vitest init
vitest init <name>
komutu, proje yapılandırmasını ayarlamak için kullanılır. Şu anda yalnızca browser
değerini desteklemektedir:
vitest init browser
vitest list
vitest list
komutu, eşleşen tüm testlerin listesini yazdırmak için tüm vitest
seçeneklerini kullanır. Bu komut reporters
seçeneğini dikkate almaz. Varsayılan olarak, dosya filtresi ve ad deseniyle eşleşen tüm testlerin adlarını yazdıracaktır:
vitest list filename.spec.ts -t="some-test"
describe > some-test
describe > some-test > test 1
describe > some-test > test 2
Testleri JSON formatında yazdırmak veya ayrı bir dosyaya kaydetmek için --json
bayrağını kullanabilirsiniz:
vitest list filename.spec.ts -t="some-test" --json=./file.json
Eğer --json
bayrağı bir değer almazsa, JSON çıktısını standart çıktıya (stdout) yazdıracaktır.
Yalnızca test dosyalarını yazdırmak için --filesOnly
bayrağını da kullanabilirsiniz:
vitest list --filesOnly
tests/test1.test.ts
tests/test2.test.ts
Seçenekler
::: ipucu Vitest, CLI argümanları için hem camel case (örn. --passWithNoTests
) hem de kebab case (örn. --pass-with-no-tests
) formatlarını destekler. --no-color
ve --inspect-brk
istisnalardır.
Vitest ayrıca değeri belirtmenin farklı yollarını da destekler: --reporter dot
ve --reporter=dot
her ikisi de geçerlidir.
Bir seçenek birden fazla değer alabiliyorsa, seçeneği birden çok kez belirtmeniz gerekir:
vitest --reporter=dot --reporter=default
Boolean seçenekleri no-
önekiyle geçersiz kılınabilir. Değeri false
olarak belirtmek de geçerlidir:
vitest --no-api
vitest --api=false
:::
root
- CLI:
-r, --root <path>
- Yapılandırma: root
Kök dizin yolu.
config
- CLI:
-c, --config <path>
Yapılandırma dosyası yolu.
update
- CLI:
-u, --update
- Yapılandırma: update
Snapshot'ları günceller.
watch
- CLI:
-w, --watch
- Yapılandırma: watch
İzleme modunu etkinleştirir.
testNamePattern
- CLI:
-t, --testNamePattern <pattern>
- Yapılandırma: testNamePattern
Belirtilen düzenli ifade deseniyle tam adları eşleşen testleri çalıştırır.
dir
- CLI:
--dir <path>
- Yapılandırma: dir
Test dosyalarını taramak için temel dizin.
ui
- CLI:
--ui
- Yapılandırma: ui
Kullanıcı arayüzünü etkinleştirir.
open
- CLI:
--open
- Yapılandırma: open
Kullanıcı arayüzünü otomatik olarak açar (varsayılan: !process.env.CI
).
api.port
- CLI:
--api.port [port]
Sunucu portunu belirtir. Belirtilen port kullanımdaysa, Vite otomatik olarak bir sonraki kullanılabilir portu dener; bu nedenle sunucunun dinleyeceği nihai port farklılık gösterebilir. Bu seçenek true
olarak ayarlanırsa, port 51204
olacaktır.
api.host
- CLI:
--api.host [host]
Sunucunun hangi IP adreslerini dinlemesi gerektiğini belirtir. LAN ve genel adresler dahil tüm adresleri dinlemek için 0.0.0.0
veya true
olarak ayarlayın.
api.strictPort
- CLI:
--api.strictPort
Port kullanımdayken bir sonraki kullanılabilir portu otomatik olarak denemek yerine uygulamadan çıkmak için true
olarak ayarlayın.
silent
- CLI:
--silent
- Yapılandırma: silent
Testlerden gelen konsol çıktısını sessize alır.
hideSkippedTests
- CLI:
--hideSkippedTests
Atlanan testlerin günlüklerini gizler.
reporters
- CLI:
--reporter <name>
- Yapılandırma: reporters
Raporlayıcıları belirtir.
outputFile
- CLI:
--outputFile <filename/-s>
- Yapılandırma: outputFile
Uyumlu bir raporlayıcı belirtildiğinde test sonuçlarını bir dosyaya yazar. Birden çok raporlayıcının ayrı çıktıları için cac'in nokta notasyonunu kullanın (örnek: --outputFile.tap=./tap.txt
).
coverage.all
- CLI:
--coverage.all
- Yapılandırma: coverage.all
Test edilmemişler de dahil olmak üzere tüm dosyaların rapora dahil edilip edilmeyeceğini belirler.
coverage.provider
- CLI:
--coverage.provider <name>
- Yapılandırma: coverage.provider
Kapsam toplama aracını seçer. Kullanılabilir değerler: "v8", "istanbul" ve "custom".
coverage.enabled
- CLI:
--coverage.enabled
- Yapılandırma: coverage.enabled
Kapsam toplamayı etkinleştirir. --coverage
CLI seçeneği kullanılarak geçersiz kılınabilir (varsayılan: false
).
coverage.include
- CLI:
--coverage.include <pattern>
- Yapılandırma: coverage.include
Kapsama dahil edilecek dosyalar glob desenleri olarak belirtilir. Birden çok desen kullanıldığında birden fazla kez belirtilebilir (varsayılan: **
).
coverage.exclude
- CLI:
--coverage.exclude <pattern>
- Yapılandırma: coverage.exclude
Kapsamdan hariç tutulacak dosyalar. Birden çok desen kullanıldığında birden fazla kez belirtilebilir (varsayılan: coverage.exclude
adresini ziyaret edin).
coverage.extension
- CLI:
--coverage.extension <extension>
- Yapılandırma: coverage.extension
Kapsama dahil edilecek uzantılar. Birden çok uzantı kullanıldığında birden fazla kez belirtilebilir (varsayılan: [".js", ".cjs", ".mjs", ".ts", ".mts", ".tsx", ".jsx", ".vue", ".svelte"]
).
coverage.clean
- CLI:
--coverage.clean
- Yapılandırma: coverage.clean
Testleri çalıştırmadan önce kapsam sonuçlarını temizler (varsayılan: true
).
coverage.cleanOnRerun
- CLI:
--coverage.cleanOnRerun
- Yapılandırma: coverage.cleanOnRerun
İzleme modunda yeniden çalıştırmada kapsam raporunu temizler (varsayılan: true
).
coverage.reportsDirectory
- CLI:
--coverage.reportsDirectory <path>
- Yapılandırma: coverage.reportsDirectory
Kapsam raporunun yazılacağı dizin (varsayılan: ./coverage
).
coverage.reporter
- CLI:
--coverage.reporter <name>
- Yapılandırma: coverage.reporter
Kullanılacak kapsam raporlayıcıları. Daha fazla bilgi için coverage.reporter
adresini ziyaret edin (varsayılan: ["text", "html", "clover", "json"]
).
coverage.reportOnFailure
- CLI:
--coverage.reportOnFailure
- Yapılandırma: coverage.reportOnFailure
Testler başarısız olsa bile kapsam raporu oluşturur (varsayılan: false
).
coverage.allowExternal
- CLI:
--coverage.allowExternal
- Yapılandırma: coverage.allowExternal
Proje kök dizini dışındaki dosyaların kapsamını toplar (varsayılan: false
).
coverage.skipFull
- CLI:
--coverage.skipFull
- Yapılandırma: coverage.skipFull
%100 ifade, dal ve fonksiyon kapsamına sahip dosyaları göstermez (varsayılan: false
).
coverage.thresholds.100
- CLI:
--coverage.thresholds.100
- Yapılandırma: coverage.thresholds.100
Tüm kapsam eşiklerini 100'e ayarlamak için kısayol (varsayılan: false
).
coverage.thresholds.perFile
- CLI:
--coverage.thresholds.perFile
- Yapılandırma: coverage.thresholds.perFile
Eşikleri dosya başına kontrol eder. Gerçek eşikler için --coverage.thresholds.lines
, --coverage.thresholds.functions
, --coverage.thresholds.branches
ve --coverage.thresholds.statements
seçeneklerine bakın (varsayılan: false
).
coverage.thresholds.autoUpdate
- CLI:
--coverage.thresholds.autoUpdate
- Yapılandırma: coverage.thresholds.autoUpdate
Mevcut kapsam yapılandırılmış eşiklerin üzerindeyse, "lines", "functions", "branches" ve "statements" eşik değerlerini yapılandırma dosyasında günceller (varsayılan: false
).
coverage.thresholds.lines
- CLI:
--coverage.thresholds.lines <number>
Satırlar için eşik. Daha fazla bilgi için istanbuljs adresini ziyaret edin. Bu seçenek özel sağlayıcılar için mevcut değildir.
coverage.thresholds.functions
- CLI:
--coverage.thresholds.functions <number>
Fonksiyonlar için eşik. Daha fazla bilgi için istanbuljs adresini ziyaret edin. Bu seçenek özel sağlayıcılar için mevcut değildir.
coverage.thresholds.branches
- CLI:
--coverage.thresholds.branches <number>
Dallar için eşik. Daha fazla bilgi için istanbuljs adresini ziyaret edin. Bu seçenek özel sağlayıcılar için mevcut değildir.
coverage.thresholds.statements
- CLI:
--coverage.thresholds.statements <number>
İfadeler için eşik. Daha fazla bilgi için istanbuljs adresini ziyaret edin. Bu seçenek özel sağlayıcılar için mevcut değildir.
coverage.ignoreClassMethods
- CLI:
--coverage.ignoreClassMethods <name>
- Yapılandırma: coverage.ignoreClassMethods
Kapsam için yoksayılacak sınıf metot adlarının dizisi. Daha fazla bilgi için istanbuljs adresini ziyaret edin. Bu seçenek yalnızca istanbul sağlayıcıları için mevcuttur (varsayılan: []
).
coverage.processingConcurrency
- CLI:
--coverage.processingConcurrency <number>
- Yapılandırma: coverage.processingConcurrency
Kapsam sonuçlarını işlerken kullanılan eşzamanlılık sınırı (varsayılan: 20 ile CPU sayısı arasındaki en küçük değer).
coverage.customProviderModule
- CLI:
--coverage.customProviderModule <path>
- Yapılandırma: coverage.customProviderModule
Özel kapsam sağlayıcı modülü için modül adını veya yolunu belirtir. Daha fazla bilgi için Özel Kapsam Sağlayıcı adresini ziyaret edin. Bu seçenek yalnızca özel sağlayıcılar için mevcuttur.
coverage.watermarks.statements
- CLI:
--coverage.watermarks.statements <watermarks>
İfadeler için yüksek ve düşük su işaretleri <high>,<low>
biçiminde.
coverage.watermarks.lines
- CLI:
--coverage.watermarks.lines <watermarks>
Satırlar için yüksek ve düşük su işaretleri <high>,<low>
biçiminde.
coverage.watermarks.branches
- CLI:
--coverage.watermarks.branches <watermarks>
Dallar için yüksek ve düşük su işaretleri <high>,<low>
biçiminde.
coverage.watermarks.functions
- CLI:
--coverage.watermarks.functions <watermarks>
Fonksiyonlar için yüksek ve düşük su işaretleri <high>,<low>
biçiminde.
mode
- CLI:
--mode <name>
- Yapılandırma: mode
Vite modunu geçersiz kılar (varsayılan: test
veya benchmark
).
workspace
- CLI:
--workspace <path>
- Yapılandırma: workspace
Çalışma alanı yapılandırma dosyası yolu.
isolate
- CLI:
--isolate
- Yapılandırma: isolate
Her test dosyasını izole bir şekilde çalıştırır. İzolasyonu devre dışı bırakmak için --no-isolate
kullanın (varsayılan: true
).
globals
- CLI:
--globals
- Yapılandırma: globals
API'leri global olarak enjekte eder.
dom
- CLI:
--dom
Tarayıcı API'sini happy-dom ile taklit eder.
browser.enabled
- CLI:
--browser.enabled
- Yapılandırma: browser.enabled
Testleri tarayıcıda çalıştırır. --browser.enabled
ile aynıdır (varsayılan: false
).
browser.name
- CLI:
--browser.name <name>
- Yapılandırma: browser.name
Tüm testleri belirli bir tarayıcıda çalıştırır. Bazı tarayıcılar yalnızca belirli sağlayıcılar için kullanılabilir (bkz. --browser.provider
). Daha fazla bilgi için browser.name
adresini ziyaret edin.
browser.headless
- CLI:
--browser.headless
- Yapılandırma: browser.headless
Tarayıcıyı başsız modda çalıştırır (yani Grafik Kullanıcı Arayüzü (GUI) açmaksızın). Vitest'i CI ortamında çalıştırıyorsanız, varsayılan olarak etkinleştirilecektir (varsayılan: process.env.CI
).
browser.api.port
- CLI:
--browser.api.port [port]
- Yapılandırma: browser.api.port
Sunucu portunu belirtir. Belirtilen port kullanımdaysa, Vite otomatik olarak bir sonraki kullanılabilir portu dener; bu nedenle sunucunun dinleyeceği nihai port farklılık gösterebilir. Bu seçenek true
olarak ayarlanırsa, port 63315
olacaktır.
browser.api.host
- CLI:
--browser.api.host [host]
- Yapılandırma: browser.api.host
Sunucunun hangi IP adreslerini dinlemesi gerektiğini belirtir. LAN ve genel adresler dahil tüm adresleri dinlemek için 0.0.0.0
veya true
olarak ayarlayın.
browser.api.strictPort
- CLI:
--browser.api.strictPort
- Yapılandırma: browser.api.strictPort
Port kullanımdayken bir sonraki kullanılabilir portu otomatik olarak denemek yerine uygulamadan çıkmak için true
olarak ayarlayın.
browser.provider
- CLI:
--browser.provider <name>
- Yapılandırma: browser.provider
Tarayıcı testlerini çalıştırmak için kullanılan sağlayıcı. Bazı tarayıcılar yalnızca belirli sağlayıcılar için kullanılabilir. "webdriverio", "playwright", "preview" veya özel bir sağlayıcının yolu olabilir. Daha fazla bilgi için browser.provider
adresini ziyaret edin (varsayılan: "preview"
).
browser.providerOptions
- CLI:
--browser.providerOptions <options>
- Yapılandırma: browser.providerOptions
Tarayıcı sağlayıcısına iletilen seçenekler. Daha fazla bilgi için browser.providerOptions
adresini ziyaret edin.
browser.isolate
- CLI:
--browser.isolate
- Yapılandırma: browser.isolate
Her tarayıcı test dosyasını izole bir şekilde çalıştırır. İzolasyonu devre dışı bırakmak için --browser.isolate=false
kullanın (varsayılan: true
).
browser.ui
- CLI:
--browser.ui
- Yapılandırma: browser.ui
Testleri çalıştırırken Vitest UI'yi gösterir (varsayılan: !process.env.CI
).
browser.fileParallelism
- CLI:
--browser.fileParallelism
- Yapılandırma: browser.fileParallelism
Tarayıcı test dosyalarının paralel çalışıp çalışmayacağını belirler. Devre dışı bırakmak için --browser.fileParallelism=false
kullanın (varsayılan: true
).
pool
- CLI:
--pool <pool>
- Yapılandırma: pool
Tarayıcıda çalışmıyorsa havuzu belirtir (varsayılan: threads
).
poolOptions.threads.isolate
- CLI:
--poolOptions.threads.isolate
- Yapılandırma: poolOptions.threads.isolate
Testleri iş parçacığı havuzunda izole eder (varsayılan: true
).
poolOptions.threads.singleThread
- CLI:
--poolOptions.threads.singleThread
- Yapılandırma: poolOptions.threads.singleThread
Testleri tek bir iş parçacığı içinde çalıştırır (varsayılan: false
).
poolOptions.threads.maxThreads
- CLI:
--poolOptions.threads.maxThreads <workers>
- Yapılandırma: poolOptions.threads.maxThreads
Testleri çalıştırmak için maksimum iş parçacığı sayısı veya yüzdesi.
poolOptions.threads.minThreads
- CLI:
--poolOptions.threads.minThreads <workers>
- Yapılandırma: poolOptions.threads.minThreads
Testleri çalıştırmak için minimum iş parçacığı sayısı veya yüzdesi.
poolOptions.threads.useAtomics
- CLI:
--poolOptions.threads.useAtomics
- Yapılandırma: poolOptions.threads.useAtomics
İş parçacıklarını senkronize etmek için Atomics kullanır. Bu bazı durumlarda performansı artırabilir, ancak eski Node sürümlerinde segmentasyon hatasına (segfault) neden olabilir (varsayılan: false
).
poolOptions.vmThreads.isolate
- CLI:
--poolOptions.vmThreads.isolate
- Yapılandırma: poolOptions.vmThreads.isolate
Testleri VM iş parçacığı havuzunda izole eder (varsayılan: true
).
poolOptions.vmThreads.singleThread
- CLI:
--poolOptions.vmThreads.singleThread
- Yapılandırma: poolOptions.vmThreads.singleThread
Testleri tek bir VM iş parçacığı içinde çalıştırır (varsayılan: false
).
poolOptions.vmThreads.maxThreads
- CLI:
--poolOptions.vmThreads.maxThreads <workers>
- Yapılandırma: poolOptions.vmThreads.maxThreads
Testleri çalıştırmak için maksimum VM iş parçacığı sayısı veya yüzdesi.
poolOptions.vmThreads.minThreads
- CLI:
--poolOptions.vmThreads.minThreads <workers>
- Yapılandırma: poolOptions.vmThreads.minThreads
Testleri çalıştırmak için minimum VM iş parçacığı sayısı veya yüzdesi.
poolOptions.vmThreads.useAtomics
- CLI:
--poolOptions.vmThreads.useAtomics
- Yapılandırma: poolOptions.vmThreads.useAtomics
İş parçacıklarını senkronize etmek için Atomics kullanır. Bu bazı durumlarda performansı artırabilir, ancak eski Node sürümlerinde segmentasyon hatasına (segfault) neden olabilir (varsayılan: false
).
poolOptions.vmThreads.memoryLimit
- CLI:
--poolOptions.vmThreads.memoryLimit <limit>
- Yapılandırma: poolOptions.vmThreads.memoryLimit
VM iş parçacığı havuzu için bellek sınırı. Bellek sızıntıları görüyorsanız, bu değeri ayarlamayı deneyin.
poolOptions.forks.isolate
- CLI:
--poolOptions.forks.isolate
- Yapılandırma: poolOptions.forks.isolate
Testleri çatal havuzunda izole eder (varsayılan: true
).
poolOptions.forks.singleFork
- CLI:
--poolOptions.forks.singleFork
- Yapılandırma: poolOptions.forks.singleFork
Testleri tek bir child_process
içinde çalıştırır (varsayılan: false
).
poolOptions.forks.maxForks
- CLI:
--poolOptions.forks.maxForks <workers>
- Yapılandırma: poolOptions.forks.maxForks
Testleri çalıştırmak için maksimum işlem sayısı veya yüzdesi.
poolOptions.forks.minForks
- CLI:
--poolOptions.forks.minForks <workers>
- Yapılandırma: poolOptions.forks.minForks
Testleri çalıştırmak için minimum işlem sayısı veya yüzdesi.
poolOptions.vmForks.isolate
- CLI:
--poolOptions.vmForks.isolate
- Yapılandırma: poolOptions.vmForks.isolate
Testleri VM çatal havuzunda izole eder (varsayılan: true
).
poolOptions.vmForks.singleFork
- CLI:
--poolOptions.vmForks.singleFork
- Yapılandırma: poolOptions.vmForks.singleFork
Testleri tek bir child_process
içinde çalıştırır (varsayılan: false
).
poolOptions.vmForks.maxForks
- CLI:
--poolOptions.vmForks.maxForks <workers>
- Yapılandırma: poolOptions.vmForks.maxForks
Testleri çalıştırmak için maksimum VM işlem sayısı veya yüzdesi.
poolOptions.vmForks.minForks
- CLI:
--poolOptions.vmForks.minForks <workers>
- Yapılandırma: poolOptions.vmForks.minForks
Testleri çalıştırmak için minimum VM işlem sayısı veya yüzdesi.
poolOptions.vmForks.memoryLimit
- CLI:
--poolOptions.vmForks.memoryLimit <limit>
- Yapılandırma: poolOptions.vmForks.memoryLimit
VM çatal havuzu için bellek sınırı. Bellek sızıntıları görüyorsanız, bu değeri ayarlamayı deneyin.
fileParallelism
- CLI:
--fileParallelism
- Yapılandırma: fileParallelism
Tüm test dosyalarının paralel çalışıp çalışmayacağını belirler. Devre dışı bırakmak için --no-file-parallelism
kullanın (varsayılan: true
).
maxWorkers
- CLI:
--maxWorkers <workers>
- Yapılandırma: maxWorkers
Testleri çalıştırmak için maksimum çalışan sayısı veya yüzdesi.
minWorkers
- CLI:
--minWorkers <workers>
- Yapılandırma: minWorkers
Testleri çalıştırmak için minimum çalışan sayısı veya yüzdesi.
environment
- CLI:
--environment <name>
- Yapılandırma: environment
Tarayıcıda çalışmıyorsa çalıştırıcı ortamını belirtir (varsayılan: node
).
passWithNoTests
- CLI:
--passWithNoTests
- Yapılandırma: passWithNoTests
Test bulunamadığında başarılı olarak kabul eder.
logHeapUsage
- CLI:
--logHeapUsage
- Yapılandırma: logHeapUsage
Node'da çalışırken her test için yığın boyutunu gösterir.
allowOnly
- CLI:
--allowOnly
- Yapılandırma: allowOnly
Yalnızca olarak işaretlenmiş testlere ve süitlere izin verir (varsayılan: !process.env.CI
).
dangerouslyIgnoreUnhandledErrors
- CLI:
--dangerouslyIgnoreUnhandledErrors
- Yapılandırma: dangerouslyIgnoreUnhandledErrors
Meydana gelen işlenmemiş hataları yoksayar.
sequence.shuffle.files
- CLI:
--sequence.shuffle.files
- Yapılandırma: sequence.shuffle.files
Dosyaları rastgele sırada çalıştırır. Bu seçeneği etkinleştirirseniz, uzun süren testler önceliklendirilmeyecektir (varsayılan: false
).
sequence.shuffle.tests
- CLI:
--sequence.shuffle.tests
- Yapılandırma: sequence.shuffle.tests
Testleri rastgele sırada çalıştırır (varsayılan: false
).
sequence.concurrent
- CLI:
--sequence.concurrent
- Yapılandırma: sequence.concurrent
Testlerin paralel çalışmasını sağlar (varsayılan: false
).
sequence.seed
- CLI:
--sequence.seed <seed>
- Yapılandırma: sequence.seed
Rastgeleleştirme tohumunu ayarlar. --sequence.shuffle
false
ise bu seçeneğin hiçbir etkisi olmaz. Daha fazla bilgi için "Random Seed" sayfası adresini ziyaret edin.
sequence.hooks
- CLI:
--sequence.hooks <order>
- Yapılandırma: sequence.hooks
Kancaların yürütülme sırasını değiştirir. Kabul edilen değerler: "stack", "list" ve "parallel". Daha fazla bilgi için sequence.hooks
adresini ziyaret edin (varsayılan: "parallel"
).
sequence.setupFiles
- CLI:
--sequence.setupFiles <order>
- Yapılandırma: sequence.setupFiles
Kurulum dosyalarının yürütülme sırasını değiştirir. Kabul edilen değerler: "list" ve "parallel". "list" olarak ayarlanırsa, kurulum dosyalarını tanımlandıkları sırayla çalıştırır. "parallel" olarak ayarlanırsa, kurulum dosyalarını paralel olarak çalıştırır (varsayılan: "parallel"
).
inspect
- CLI:
--inspect [[host:]port]
- Yapılandırma: inspect
Node.js denetleyicisini etkinleştirir (varsayılan: 127.0.0.1:9229
).
inspectBrk
- CLI:
--inspectBrk [[host:]port]
- Yapılandırma: inspectBrk
Node.js denetleyicisini etkinleştirir ve test başlamadan önce duraklatır.
testTimeout
- CLI:
--testTimeout <timeout>
- Yapılandırma: testTimeout
Bir testin varsayılan zaman aşımı milisaniye cinsindendir (varsayılan: 5000
).
hookTimeout
- CLI:
--hookTimeout <timeout>
- Yapılandırma: hookTimeout
Varsayılan kanca zaman aşımı milisaniye cinsindendir (varsayılan: 10000
).
bail
- CLI:
--bail <number>
- Yapılandırma: bail
Belirtilen sayıda test başarısız olduğunda test yürütmeyi durdurur (varsayılan: 0
).
retry
- CLI:
--retry <times>
- Yapılandırma: retry
Test başarısız olursa belirli sayıda kez tekrar dener (varsayılan: 0
).
diff
- CLI:
--diff <path>
- Yapılandırma: diff
Fark arayüzü oluşturmak için kullanılacak bir fark yapılandırmasının yolu.
exclude
- CLI:
--exclude <glob>
- Yapılandırma: exclude
Testten hariç tutulacak ek dosya globları.
expandSnapshotDiff
- CLI:
--expandSnapshotDiff
- Yapılandırma: expandSnapshotDiff
Anlık görüntü başarısız olduğunda tam farkı gösterir.
disableConsoleIntercept
- CLI:
--disableConsoleIntercept
- Yapılandırma: disableConsoleIntercept
Konsol günlüğünün otomatik olarak kesilmesini devre dışı bırakır (varsayılan: false
).
typecheck.enabled
- CLI:
--typecheck.enabled
- Yapılandırma: typecheck.enabled
Testlerle birlikte tür denetimini etkinleştirir (varsayılan: false
).
typecheck.only
- CLI:
--typecheck.only
- Yapılandırma: typecheck.only
Yalnızca tür denetimi testlerini çalıştırır. Bu, tür denetimini otomatik olarak etkinleştirir (varsayılan: false
).
typecheck.checker
- CLI:
--typecheck.checker <name>
- Yapılandırma: typecheck.checker
Kullanılacak tür denetleyicisini belirtir. Kullanılabilir değerler: "tsc", "vue-tsc" ve bir yürütülebilir dosyanın yolu (varsayılan: "tsc"
).
typecheck.allowJs
- CLI:
--typecheck.allowJs
- Yapılandırma: typecheck.allowJs
JavaScript dosyalarının tür denetimine tabi tutulmasına izin verir. Varsayılan olarak tsconfig.json
dosyasındaki değeri alır.
typecheck.ignoreSourceErrors
- CLI:
--typecheck.ignoreSourceErrors
- Yapılandırma: typecheck.ignoreSourceErrors
Kaynak dosyalardaki tür hatalarını yoksayar.
typecheck.tsconfig
- CLI:
--typecheck.tsconfig <path>
- Yapılandırma: typecheck.tsconfig
Özel bir tsconfig
dosyasına giden yol.
project
- CLI:
--project <name>
- Yapılandırma: project
Vitest çalışma alanı özelliğini kullanıyorsanız çalıştırılacak projenin adı. Bu, birden çok proje için tekrarlanabilir: --project=1 --project=2
. Ayrıca --project=packages*
gibi joker karakterler kullanarak projeleri filtreleyebilirsiniz.
slowTestThreshold
- CLI:
--slowTestThreshold <threshold>
- Yapılandırma: slowTestThreshold
Bir testin yavaş kabul edilmesi için milisaniye cinsinden eşiktir (varsayılan: 300
).
teardownTimeout
- CLI:
--teardownTimeout <timeout>
- Yapılandırma: teardownTimeout
Bir teardown fonksiyonunun varsayılan zaman aşımı milisaniye cinsindendir (varsayılan: 10000
).
maxConcurrency
- CLI:
--maxConcurrency <number>
- Yapılandırma: maxConcurrency
Bir süitteki eşzamanlı testlerin maksimum sayısıdır (varsayılan: 5
).
expect.requireAssertions
- CLI:
--expect.requireAssertions
- Yapılandırma: expect.requireAssertions
Tüm testlerin en az bir onaylamaya sahip olmasını gerektirir.
expect.poll.interval
- CLI:
--expect.poll.interval <interval>
- Yapılandırma: expect.poll.interval
expect.poll()
onaylamaları için milisaniye cinsinden yoklama aralığıdır (varsayılan: 50
).
expect.poll.timeout
- CLI:
--expect.poll.timeout <timeout>
- Yapılandırma: expect.poll.timeout
expect.poll()
onaylamaları için milisaniye cinsinden yoklama zaman aşımıdır (varsayılan: 1000
).
printConsoleTrace
- CLI:
--printConsoleTrace
- Yapılandırma: printConsoleTrace
Konsol yığın izlerini her zaman yazdırır.
run
- CLI:
--run
İzleme modunu devre dışı bırakır.
color
- CLI:
--no-color
Konsol çıktısından renkleri kaldırır.
clearScreen
- CLI:
--clearScreen
İzleme modunda testleri yeniden çalıştırırken terminal ekranını temizler (varsayılan: true
).
standalone
- CLI:
--standalone
Testleri çalıştırmadan Vitest'i başlatır. Dosya filtreleri göz ardı edilir, testler yalnızca değişiklik olduğunda çalışır (varsayılan: false
).
changed
- Tip:
boolean | string
- Varsayılan:
false
Yalnızca değişen dosyalardaki testleri çalıştırır. Eğer bir değer sağlanmazsa, kaydedilmemiş değişiklikler (sahnelenmiş ve sahnelenmemiş değişiklikler dahil) için testleri çalıştırır.
Son commit'te yapılan değişikliklere karşı testleri çalıştırmak için --changed HEAD~1
kullanabilirsiniz. Ayrıca commit hash'i (örn. --changed 09a9920
) veya dal adı (örn. --changed origin/develop
) geçirebilirsiniz.
Kod kapsamı ile kullanıldığında, rapor yalnızca değişikliklerle ilgili dosyaları içerir.
forceRerunTriggers
yapılandırma seçeneğiyle birlikte kullanıldığında, forceRerunTriggers
listesinde belirtilen dosyalardan en az biri değişirse tüm test suitini çalıştırır. Varsayılan olarak, Vitest yapılandırma dosyasındaki ve package.json
'daki değişiklikler her zaman tüm paketi yeniden çalıştırır.
shard
- Tip:
string
- Varsayılan: disabled
Çalıştırılacak test paketi bölümünü <index>
/<count>
formatında belirtir, burada:
count
: Pozitif bir tam sayı olup, testlerin bölüneceği parça sayısını gösterir.index
: Pozitif bir tam sayı olup, çalıştırılacak parçanın indeksini gösterir.
Bu komut, tüm testleri count
eşit parçaya böler ve yalnızca index
parçasına denk gelenleri çalıştırır. Örneğin, test paketinizi üç parçaya bölmek için şunu kullanın:
vitest run --shard=1/3
vitest run --shard=2/3
vitest run --shard=3/3
::: uyarı Bu seçeneği --watch
etkin durumdayken (varsayılan olarak geliştirme ortamında etkin) kullanamazsınız. :::
::: ipucu Eğer --reporter=blob
bir çıktı dosyası olmadan kullanılırsa, varsayılan yol diğer Vitest süreçleriyle çakışmaları önlemek için mevcut shard yapılandırmasını içerir. :::
merge-reports
- Tip:
boolean | string
Belirtilen klasörde (.vitest-reports
varsayılan olarak) bulunan tüm blob raporlarını birleştirir. Bu komutla herhangi bir raporlayıcıyı ( blob
hariç) kullanabilirsiniz:
vitest --merge-reports --reporter=junit