Skip to content
Vitest 3
Main Navigation Kılavuz & APIYapılandırmaTarayıcı ModuGelişmiş API
3.2.0
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

Giriş

Neden Vitest

Başlarken

Özellikler

Vitest'i Yapılandırma

API

Test API Referansları

Mock Fonksiyonlar

Vi

expect

expectTypeOf

assert

assertType

Kılavuz

Komut Satırı Arayüzü

Test Filtreleme

Test Projeleri

Raporlayıcılar

Kapsam

Anlık Görüntüler

Mocking

Paralellik

Tür Testleri

Vitest UI

Kaynak İçi Test

Test Ortamı

Test Açıklamaları

Test Ortamı

Eşleştiricileri Genişletme

IDE Entegrasyonları

Hata Ayıklama

Sık Karşılaşılan Hatalar

Geçiş Kılavuzu

Vitest 3.0'a Geçiş

Jest'ten Geçiş

Performans

Test Performansını Profillendirme

Performansı İyileştirme

Tarayıcı Modu

Gelişmiş API

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

Bu sayfada

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:

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

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

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

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

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

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

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ırı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ı geçirebilirsiniz:

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

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

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

sh
vitest --merge-reports --reporter=junit
Pager
Önceki sayfaassertType
Sonraki sayfaTest Filtreleme

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

Copyright (c) 2021-Present Vitest Team

https://vitest.dev/guide/cli

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

Copyright (c) 2021-Present Vitest Team