Komut Satırı Arayüzü
Komutlar
vitest
Geçerli dizinde Vitest'i başlatır. Geliştirme ortamında otomatik olarak izleme moduna geçerken, CI'da (veya etkileşimli olmayan bir terminalde) çalıştırma modunda başlar.
Ç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ırır. Bu filtre yalnızca içerip içermediğini kontrol eder ve düzenli ifadeleri veya glob desenlerini desteklemez (terminaliniz filtreyi Vitest'e iletmeden önce işlemediği sürece).
Vitest 3'ten itibaren, testleri dosya adı ve satır numarasıyla da belirtebilirsiniz:
$ vitest basic/foo.test.ts:10
WARNING
Vitest'in bu özelliğin çalışabilmesi için tam dosya adını gerektirdiğini unutmayın. Bu, geçerli çalışma dizinine göre göreceli veya mutlak bir dosya yolu olabilir.
$ vitest basic/foo.js:10 # ✅
$ vitest ./basic/foo.js:10 # ✅
$ vitest /users/project/basic/foo.js:10 # ✅
$ vitest foo:10 # ❌
$ vitest ./basic/foo:10 # ❌
Şu anda Vitest, aralıkları da desteklememektedir:
$ vitest basic/foo.test.ts:10, basic/foo.test.ts:25 # ✅
$ vitest basic/foo.test.ts:10-25 # ❌
vitest run
İzleme modu olmadan tek bir test çalıştırması gerçekleştirir.
vitest watch
Tüm test paketlerini çalıştırır, ancak değişiklikleri izler ve dosyalarda bir değişiklik olduğunda ilgili testleri yeniden çalıştırır. Argüman olmadan vitest
komutunu çağırmakla aynı işlevi görür. CI ortamında veya stdin bir TTY olmadığında (etkileşimli olmayan ortam), vitest run
komutuna geri döner.
vitest dev
vitest watch
için bir takma addır.
vitest related
Yalnızca belirli bir kaynak dosyaları listesini kapsayan testleri çalıştırır. Statik içe aktarmalarla (örn. import('./index.js')
veya import index from './index.js
) çalışır, ancak dinamik olanlarla (örn. import(filepath)
) çalışmaz. Tüm dosyalar kök dizine göre belirtilmelidir.
lint-staged
veya CI kurulumunuzla birlikte çalıştırmak için kullanışlıdır.
vitest related /src/index.ts /src/hello-world.js
TIP
Vitest'in varsayılan olarak izleme modu etkin olarak çalıştığını unutmayın. lint-staged
gibi araçlar kullanıyorsanız, komutun normal olarak sonlanabilmesi için --run
seçeneğini de eklemelisiniz.
export default {
'*.{js,ts}': 'vitest related --run',
};
vitest bench
Yalnızca performans sonuçlarını karşılaştıran benchmark testlerini çalıştırır.
vitest init
vitest init <name>
komutu, proje yapılandırmasını başlatmak için kullanılabilir. Ş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ırı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ı geçirebilirsiniz:
vitest list filename.spec.ts -t="some-test" --json=./file.json
Eğer --json
bayrağı bir değer almazsa, JSON çıktısını stdout'a verir.
Yalnızca test dosyalarını yazdırmak için --filesOnly
bayrağını da geçirebilirsiniz:
vitest list --filesOnly
tests/test1.test.ts
tests/test2.test.ts
Seçenekler
TIP
Vitest, CLI argümanları için hem camel case hem de kebab case'i destekler. Örneğin, --passWithNoTests
ve --pass-with-no-tests
ikisi de çalışır (--no-color
ve --inspect-brk
istisnalardır).
Vitest ayrıca değeri belirtmenin farklı yollarını da destekler: --reporter dot
ve --reporter=dot
ikisi de geçerlidir.
Eğer seçenek bir dizi değer destekliyorsa, bu seçeneği birden fazla kez geçmeniz gerekir:
vitest --reporter=dot --reporter=default
Mantıksal seçenekler no-
önekiyle olumsuzlanabilir. 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 dizini belirtir.
config
- CLI:
-c, --config <path>
Yapılandırma dosyasının yolunu belirtir.
update
- CLI:
-u, --update
- Yapılandırma: update
Anlık görüntüleri (snapshot) 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 (regexp) deseniyle tam adları eşleşen testleri çalıştırır.
dir
- CLI:
--dir <path>
- Yapılandırma: dir
Test dosyalarını aramak için temel dizini belirtir.
ui
- CLI:
--ui
- Yapılandırma: ui
Kullanıcı arayüzünü (UI) 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 zaten kullanılıyorsa, Vite otomatik olarak bir sonraki kullanılabilir portu deneyecektir; bu nedenle, bu, sunucunun dinlediği gerçek port olmayabilir. Bu seçenek true
olarak ayarlanırsa, port 51204
olarak belirlenecektir.
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 zaten kullanılıyorsa, otomatik olarak bir sonraki kullanılabilir portu denemek yerine uygulamanın çıkması için true
olarak ayarlayın.
silent
- CLI:
--silent [value]
- Yapılandırma: silent
Testlerden gelen konsol çıktısını sessize alır. Yalnızca başarısız olan testlerin günlüklerini görmek için 'passed-only'
kullanın.
hideSkippedTests
- CLI:
--hideSkippedTests
Atlanan testlerin günlüklerini gizler.
reporters
- CLI:
--reporter <name>
- Yapılandırma: reporters
Kullanılacak raporlayıcıları belirtir (default, basic, blob, verbose, dot, json, tap, tap-flat, junit, hanging-process, github-actions).
outputFile
- CLI:
--outputFile <filename/-s>
- Yapılandırma: outputFile
Desteklenen bir raporlayıcı da belirtildiğinde test sonuçlarını bir dosyaya yazar. Birden fazla raporlayıcının bireysel çıktıları için cac'in nokta gösterimini kullanın (örnek: --outputFile.tap=./tap.txt
).
coverage.all
- CLI:
--coverage.all
- Yapılandırma: coverage.all
Test edilmemiş dosyalar da dahil olmak üzere tüm dosyaların kapsama raporuna dahil edilip edilmeyeceğini belirler.
coverage.provider
- CLI:
--coverage.provider <name>
- Yapılandırma: coverage.provider
Kapsam toplama aracını seçer. Mevcut 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 belirtir. Birden fazla 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ı belirtir. Birden fazla uzantı kullanıldığında birden fazla kez belirtilebilir (varsayılan: Daha fazla bilgi için coverage.exclude
adresini ziyaret edin).
coverage.extension
- CLI:
--coverage.extension <extension>
- Yapılandırma: coverage.extension
Kapsama dahil edilecek uzantıları belirtir. Birden fazla 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ğı dizini belirtir (varsayılan: ./coverage
).
coverage.reporter
- CLI:
--coverage.reporter <name>
- Yapılandırma: coverage.reporter
Kullanılacak kapsam raporlayıcılarını belirtir. 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şturulmasını sağlar (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
Dosya başına eşikleri 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ına günceller (varsayılan: false
).
coverage.thresholds.lines
- CLI:
--coverage.thresholds.lines <number>
Satırlar için eşik değeri. Daha fazla bilgi için istanbuljs adresini ziyaret edin. Bu seçenek özel sağlayıcılar için kullanılamaz.
coverage.thresholds.functions
- CLI:
--coverage.thresholds.functions <number>
Fonksiyonlar için eşik değeri. Daha fazla bilgi için istanbuljs adresini ziyaret edin. Bu seçenek özel sağlayıcılar için kullanılamaz.
coverage.thresholds.branches
- CLI:
--coverage.thresholds.branches <number>
Dallar için eşik değeri. Daha fazla bilgi için istanbuljs adresini ziyaret edin. Bu seçenek özel sağlayıcılar için kullanılamaz.
coverage.thresholds.statements
- CLI:
--coverage.thresholds.statements <number>
İfadeler için eşik değeri. Daha fazla bilgi için istanbuljs adresini ziyaret edin. Bu seçenek özel sağlayıcılar için kullanılamaz.
coverage.ignoreClassMethods
- CLI:
--coverage.ignoreClassMethods <name>
- Yapılandırma: coverage.ignoreClassMethods
Kapsam için yoksayılacak sınıf metot adları 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 ve CPU sayısı arasında daha küçük olan 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ı ya da 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
[Kullanımdan kaldırıldı] Çalışma alanı yapılandırma dosyasının yolu.
isolate
- CLI:
--isolate
- Yapılandırma: isolate
Her test dosyasını yalıtılmış olarak çalıştırır. Yalıtımı 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 (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 (yani GUI (Grafik Kullanıcı Arayüzü) açmadan) çalıştırır. 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 zaten kullanılıyorsa, Vite otomatik olarak bir sonraki kullanılabilir portu deneyecektir; bu nedenle, bu, sunucunun dinlediği gerçek port olmayabilir. Bu seçenek true
olarak ayarlanırsa, port 63315
olarak belirlenecektir.
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 zaten kullanılıyorsa, otomatik olarak bir sonraki kullanılabilir portu denemek yerine uygulamanın çıkması 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ıyı belirtir. 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çenekleri belirtir. 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ı yalıtılmış olarak çalıştırır. Yalıtımı devre dışı bırakmak için --browser.isolate=false
kullanın (varsayılan: true
).
browser.ui
- CLI:
--browser.ui
- Yapılandırma: browser.ui
Testler çalışı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 olarak çalıştırılıp çalıştırılmayacağını belirler. Devre dışı bırakmak için --browser.fileParallelism=false
kullanın (varsayılan: true
).
browser.connectTimeout
- CLI:
--browser.connectTimeout <timeout>
- Yapılandırma: browser.connectTimeout
Tarayıcıya bağlantı belirtilen süreden daha uzun sürerse, test paketinin başarısız olmasını sağlar (varsayılan: 60_000
).
pool
- CLI:
--pool <pool>
- Yapılandırma: pool
Tarayıcıda çalışmıyorsa kullanılacak havuzu belirtir (varsayılan: forks
).
poolOptions.threads.isolate
- CLI:
--poolOptions.threads.isolate
- Yapılandırma: poolOptions.threads.isolate
Testleri thread havuzunda izole eder (varsayılan: true
).
poolOptions.threads.singleThread
- CLI:
--poolOptions.threads.singleThread
- Yapılandırma: poolOptions.threads.singleThread
Testleri tek bir thread'de ç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 segfault'a neden olabilir (varsayılan: false
).
poolOptions.vmThreads.isolate
- CLI:
--poolOptions.vmThreads.isolate
- Yapılandırma: poolOptions.vmThreads.isolate
Testleri VM iş parçacığı havuzunda yalıtır (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 segfault'a 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ı yaşıyorsanız, bu değeri değiştirin.
poolOptions.forks.isolate
- CLI:
--poolOptions.forks.isolate
- Yapılandırma: poolOptions.forks.isolate
Testleri çatal havuzunda yalıtır (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 yalıtır (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ı yaşıyorsanız, bu değeri değiştirin.
fileParallelism
- CLI:
--fileParallelism
- Yapılandırma: fileParallelism
Tüm test dosyalarının paralel olarak çalıştırılıp çalıştırılmayacağı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 bulunmadığında test paketinin başarılı sayılmasını sağlar.
logHeapUsage
- CLI:
--logHeapUsage
- Yapılandırma: logHeapUsage
Node'da çalışırken her test için yığın (heap) boyutunu gösterir.
allowOnly
- CLI:
--allowOnly
- Yapılandırma: allowOnly
Yalnızca çalıştırılacak olarak işaretlenmiş testlere ve süitlere izin verir (varsayılan: !process.env.CI
).
dangerouslyIgnoreUnhandledErrors
- CLI:
--dangerouslyIgnoreUnhandledErrors
- Yapılandırma: dangerouslyIgnoreUnhandledErrors
Oluşan 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 daha erken başlamaz (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
Testleri paralel çalıştırır (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 durdurur.
testTimeout
- CLI:
--testTimeout <timeout>
- Yapılandırma: testTimeout
Bir testin varsayılan zaman aşımı milisaniye cinsinden (varsayılan: 5000
). Zaman aşımını tamamen devre dışı bırakmak için 0
kullanın.
hookTimeout
- CLI:
--hookTimeout <timeout>
- Yapılandırma: hookTimeout
Varsayılan kanca zaman aşımı milisaniye cinsinden (varsayılan: 10000
). Zaman aşımını tamamen devre dışı bırakmak için 0
kullanın.
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.aAnnotation
- CLI:
--diff.aAnnotation <annotation>
- Yapılandırma: diff.aAnnotation
Beklenen satırlar için açıklama (varsayılan: Expected
).
diff.aIndicator
- CLI:
--diff.aIndicator <indicator>
- Yapılandırma: diff.aIndicator
Beklenen satırlar için gösterge (varsayılan: -
).
diff.bAnnotation
- CLI:
--diff.bAnnotation <annotation>
- Yapılandırma: diff.bAnnotation
Alınan satırlar için açıklama (varsayılan: Received
).
diff.bIndicator
- CLI:
--diff.bIndicator <indicator>
- Yapılandırma: diff.bIndicator
Alınan satırlar için gösterge (varsayılan: +
).
diff.commonIndicator
- CLI:
--diff.commonIndicator <indicator>
- Yapılandırma: diff.commonIndicator
Ortak satırlar için gösterge (varsayılan: ).
diff.contextLines
- CLI:
--diff.contextLines <lines>
- Yapılandırma: diff.contextLines
Her değişikliğin etrafında gösterilecek bağlam satırı sayısı (varsayılan: 5
).
diff.emptyFirstOrLastLinePlaceholder
- CLI:
--diff.emptyFirstOrLastLinePlaceholder <placeholder>
- Yapılandırma: diff.emptyFirstOrLastLinePlaceholder
Boş ilk veya son satır için yer tutucu (varsayılan: ""
).
diff.expand
- CLI:
--diff.expand
- Yapılandırma: diff.expand
Tüm ortak satırları genişletir (varsayılan: true
).
diff.includeChangeCounts
- CLI:
--diff.includeChangeCounts
- Yapılandırma: diff.includeChangeCounts
Fark çıktısına karşılaştırma sayılarını dahil eder (varsayılan: false
).
diff.omitAnnotationLines
- CLI:
--diff.omitAnnotationLines
- Yapılandırma: diff.omitAnnotationLines
Çıktıdan açıklama satırlarını çıkarır (varsayılan: false
).
diff.printBasicPrototype
- CLI:
--diff.printBasicPrototype
- Yapılandırma: diff.printBasicPrototype
Temel prototip Nesnesini ve Dizisini yazdırır (varsayılan: true
).
diff.maxDepth
- CLI:
--diff.maxDepth <maxDepth>
- Yapılandırma: diff.maxDepth
İç içe nesneleri yazdırırken özyineleme derinliğini sınırlar (varsayılan: 20
).
diff.truncateThreshold
- CLI:
--diff.truncateThreshold <threshold>
- Yapılandırma: diff.truncateThreshold
Her değişiklikten önce ve sonra gösterilecek satır sayısı (varsayılan: 0
).
diff.truncateAnnotation
- CLI:
--diff.truncateAnnotation <annotation>
- Yapılandırma: diff.truncateAnnotation
Kısaltılmış satırlar için açıklama (varsayılan: ... Diff sonucu kısaltıldı
).
exclude
- CLI:
--exclude <glob>
- Yapılandırma: exclude
Testten hariç tutulacak ek dosya glob desenleri.
expandSnapshotDiff
- CLI:
--expandSnapshotDiff
- Yapılandırma: expandSnapshotDiff
Snapshot başarısız olduğunda tam farkı (diff) gösterir.
disableConsoleIntercept
- CLI:
--disableConsoleIntercept
- Yapılandırma: disableConsoleIntercept
Konsol günlüklerinin otomatik olarak yakalanmasını 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. Mevcut değerler: "tsc" ve "vue-tsc" ve yürütülebilir bir dosyanın yolu (varsayılan: "tsc"
).
typecheck.allowJs
- CLI:
--typecheck.allowJs
- Yapılandırma: typecheck.allowJs
JavaScript dosyalarının tür denetimine izin verir. Varsayılan olarak tsconfig.json'dan 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 yolu belirtir.
typecheck.spawnTimeout
- CLI:
--typecheck.spawnTimeout <time>
- Yapılandırma: typecheck.spawnTimeout
Tür denetleyicisini başlatmak için gereken minimum süre milisaniye cinsinden.
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 fazla proje için tekrarlanabilir: --project=1 --project=2
. Ayrıca --project=packages*
gibi joker karakterler kullanarak projeleri filtreleyebilir ve --project=!pattern
ile projeleri hariç tutabilirsiniz.
slowTestThreshold
- CLI:
--slowTestThreshold <threshold>
- Yapılandırma: slowTestThreshold
Bir testin veya süitin yavaş kabul edilmesi için milisaniye cinsinden eşik (varsayılan: 300
).
teardownTimeout
- CLI:
--teardownTimeout <timeout>
- Yapılandırma: teardownTimeout
Bir teardown fonksiyonunun varsayılan zaman aşımı milisaniye cinsinden (varsayılan: 10000
).
maxConcurrency
- CLI:
--maxConcurrency <number>
- Yapılandırma: maxConcurrency
Bir süitteki eşzamanlı testlerin maksimum sayısı (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 yoklama aralığı milisaniye cinsinden (varsayılan: 50
).
expect.poll.timeout
- CLI:
--expect.poll.timeout <timeout>
- Yapılandırma: expect.poll.timeout
expect.poll()
onaylamaları için yoklama zaman aşımı milisaniye cinsinden (varsayılan: 1000
).
printConsoleTrace
- CLI:
--printConsoleTrace
- Yapılandırma: printConsoleTrace
Konsol yığın izlerini her zaman yazdırır.
includeTaskLocation
- CLI:
--includeTaskLocation
- Yapılandırma: includeTaskLocation
Test ve süit konumlarını location
özelliğinde toplar.
attachmentsDir
- CLI:
--attachmentsDir <dir>
- Yapılandırma: attachmentsDir
context.annotate
'den gelen eklerin depolandığı dizin (varsayılan: .vitest-attachments
).
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
).
configLoader
- CLI:
--configLoader <loader>
Yapılandırmayı esbuild ile paketlemek için bundle
veya anında işlemek için runner
(deneysel) kullanın. Bu yalnızca Vite sürüm 6.1.0 ve üzeri için kullanılabilir (varsayılan: bundle
).
standalone
- CLI:
--standalone
Testleri çalıştırmadan Vitest'i başlatır. Dosya filtreleri yoksayılacak, testler yalnızca değişiklikte çalışacaktır (varsayılan: false
).
changed
- Tip:
boolean | string
- Varsayılan:
false
Yalnızca değişen dosyalara karşı testleri çalıştırır. Bir değer sağlanmazsa, kaydedilmemiş değişikliklere (staged ve unstaged değişiklikler dahil) karşı 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 branch adını (ö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 eşleştirildiğinde, forceRerunTriggers
listesinde listelenen dosyalardan en az biri değişirse tüm test paketini yeniden çalıştırır. Varsayılan olarak, Vitest yapılandırma dosyasındaki ve package.json
'daki değişiklikler her zaman tüm test paketini yeniden çalıştırır.
shard
- Tip:
string
- Varsayılan: disabled
<index>
/<count>
formatında yürütülecek test paketi parçası, burada:
count
pozitif bir tam sayıdır, bölünecek parça sayısıindex
pozitif bir tam sayıdır, bölünen parçanın indeksi
Bu komut, tüm testleri count
eşit parçaya böler ve yalnızca index
parçasında bulunanları ç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
WARNING
Bu seçeneği --watch
etkin durumdayken (varsayılan olarak geliştirme ortamında etkin) kullanamazsınız.
TIP
Eğer --reporter=blob
bir çıktı dosyası olmadan kullanılırsa, varsayılan yol diğer Vitest işlemleriyle çakışmaları önlemek için geçerli parça yapılandırmasını içerir.
merge-reports
- Tip:
boolean | string
Belirtilen klasörde (varsayılan olarak .vitest-reports
) bulunan tüm blob raporlarını birleştirir. Bu komutla herhangi bir raporlayıcıyı kullanabilirsiniz ( blob
hariç):
vitest --merge-reports --reporter=junit