Skip to content
Vitest 2
Main Navigation KılavuzAPIYapılandırmaTarayıcı Moduİleri
2.1.9
1.6.1
0.34.6

Türkçe

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
čeština
magyar

Türkçe

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
čeština
magyar

Görünüm

Sidebar Navigation

Neden Vitest

Başlangıç

Özellikler

Çalışma Alanı

Komut Satırı Arayüzü

Test Filtreleme

Raporlayıcılar

Kapsam

Anlık Görüntü (Snapshot) Testleri

Sahtecilik (Mocking)

Türleri Test Etme

Vitest Arayüzü

Kaynak İçi Test

Test Bağlamı

Test Ortamı

Eşleştiricileri Genişletme

IDE Tümleştirmeleri

Hata Ayıklama

Diğer Test Çalıştırıcılarıyla Karşılaştırmalar

Geçiş Rehberi

Yaygın Hatalar

Profiling Test Performance

Performansı İyileştirme

Bu sayfada

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:

bash
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.

bash
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.

js
// .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:

bash
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:

shell
vitest list filename.spec.ts -t="some-test"
txt
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:

bash
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:

bash
vitest list --filesOnly
txt
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:

sh
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:

sh
vitest --merge-reports --reporter=junit
Pager
Önceki sayfaÇalışma Alanı
Sonraki sayfaTest Filtreleme

MIT Lisansı altında yayınlanmıştır.

Copyright (c) 2024 Mithril Contributors

https://v2.vitest.dev/guide/cli

MIT Lisansı altında yayınlanmıştır.

Copyright (c) 2024 Mithril Contributors