Vitest 2

Português – Brasil

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

Português – Brasil

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

Aparência

root ​

  • CLI: -r, --root <path>
  • Config: root

Define o caminho da raiz do projeto.

config ​

  • CLI: -c, --config <path>

Define o caminho para o arquivo de configuração.

update ​

  • CLI: -u, --update
  • Config: update

Atualiza os snapshots.

watch ​

  • CLI: -w, --watch
  • Config: watch

Habilita o modo de observação (watch mode).

testNamePattern ​

Executa testes cujos nomes completos correspondem ao padrão de expressão regular especificado.

dir ​

  • CLI: --dir <path>
  • Config: dir

Define o diretório base para escanear arquivos de teste.

ui ​

  • CLI: --ui
  • Config: ui

Habilita a interface de usuário (UI).

open ​

  • CLI: --open
  • Config: open

Abre a UI automaticamente (padrão: !process.env.CI).

api.port ​

  • CLI: --api.port [port]

Especifica a porta do servidor. Se a porta já estiver em uso, o Vite tentará automaticamente a próxima porta disponível, o que significa que esta pode não ser a porta real em que o servidor acabará escutando. Se true, será definida como 51204.

api.host ​

  • CLI: --api.host [host]

Especifica em quais endereços IP o servidor deve escutar. Defina como 0.0.0.0 ou true para escutar em todos os endereços, incluindo LAN e endereços públicos.

api.strictPort ​

  • CLI: --api.strictPort

Se true, o Vitest será encerrado se a porta já estiver em uso, em vez de tentar automaticamente a próxima porta disponível.

silent ​

Suprime a saída do console dos testes.

hideSkippedTests ​

  • CLI: --hideSkippedTests

Oculta os logs de testes ignorados (skipped tests).

reporters ​

Especifica os relatores (reporters) a serem usados.

outputFile ​

Escreve os resultados do teste em um arquivo quando um relator compatível também é especificado. Use a notação de ponto para saídas individuais de múltiplos relatores (exemplo: --outputFile.tap=./tap.txt).

coverage.all ​

Define se todos os arquivos, incluindo os não testados, devem ser incluídos no relatório de cobertura.

coverage.provider ​

Seleciona a ferramenta para coleta de cobertura. Os valores disponíveis são: "v8", "istanbul" e "custom".

coverage.enabled ​

Habilita a coleta de cobertura. Pode ser substituído usando a opção CLI --coverage (padrão: false).

coverage.include ​

Padrões glob para arquivos a serem incluídos na cobertura. Pode ser especificado mais de uma vez ao usar múltiplos padrões (padrão: **).

coverage.exclude ​

Padrões glob para arquivos a serem excluídos da cobertura. Pode ser especificado mais de uma vez ao usar múltiplos padrões (padrão: Consulte coverage.exclude).

coverage.extension ​

Extensões de arquivo a serem incluídas na cobertura. Pode ser especificada mais de uma vez ao usar múltiplas extensões (padrão: [".js", ".cjs", ".mjs", ".ts", ".mts", ".tsx", ".jsx", ".vue", ".svelte"]).

coverage.clean ​

Limpa os resultados de cobertura antes de executar os testes (padrão: true).

coverage.cleanOnRerun ​

Limpa o relatório de cobertura na reexecução do modo de observação (padrão: true).

coverage.reportsDirectory ​

Diretório para gerar o relatório de cobertura (padrão: ./coverage).

coverage.reporter ​

Relatores de cobertura a serem usados. Consulte coverage.reporter para mais informações (padrão: ["text", "html", "clover", "json"]).

coverage.reportOnFailure ​

Gera o relatório de cobertura mesmo quando os testes falham (padrão: false).

coverage.allowExternal ​

Coleta cobertura de arquivos fora da raiz do projeto (padrão: false).

coverage.skipFull ​

Não exibe arquivos com 100% de cobertura de declarações, branches e funções (padrão: false).

coverage.thresholds.100 ​

Atalho para definir todos os limites de cobertura para 100% (padrão: false).

coverage.thresholds.perFile ​

Verifica os limites de cobertura por arquivo. Consulte --coverage.thresholds.lines, --coverage.thresholds.functions, --coverage.thresholds.branches e --coverage.thresholds.statements para os limites reais (padrão: false).

coverage.thresholds.autoUpdate ​

Atualiza os valores de limite: "lines", "functions", "branches" e "statements" no arquivo de configuração quando a cobertura atual estiver acima dos limites configurados (padrão: false).

coverage.thresholds.lines ​

  • CLI: --coverage.thresholds.lines <number>

Define o limite mínimo de cobertura para linhas. Consulte istanbuljs para mais informações. Esta opção não está disponível para provedores personalizados.

coverage.thresholds.functions ​

  • CLI: --coverage.thresholds.functions <number>

Define o limite mínimo de cobertura para funções. Consulte istanbuljs para mais informações. Esta opção não está disponível para provedores personalizados.

coverage.thresholds.branches ​

  • CLI: --coverage.thresholds.branches <number>

Define o limite mínimo de cobertura para branches. Consulte istanbuljs para mais informações. Esta opção não está disponível para provedores personalizados.

coverage.thresholds.statements ​

  • CLI: --coverage.thresholds.statements <number>

Define o limite mínimo de cobertura para declarações. Consulte istanbuljs para mais informações. Esta opção não está disponível para provedores personalizados.

coverage.ignoreClassMethods ​

Array de nomes de métodos de classe a serem ignorados para cobertura. Consulte istanbuljs para mais informações. Esta opção está disponível apenas para os provedores Istanbul (padrão: []).

coverage.processingConcurrency ​

Limite de concorrência usado ao processar os resultados da cobertura (padrão: o menor valor entre 20 e o número de CPUs).

coverage.customProviderModule ​

Especifica o nome ou caminho do módulo para o provedor de cobertura personalizado. Consulte Custom Coverage Provider para mais informações. Esta opção está disponível apenas para provedores personalizados.

coverage.watermarks.statements ​

  • CLI: --coverage.watermarks.statements <watermarks>

Limites superior e inferior para declarações no formato de <superior>,<inferior>.

coverage.watermarks.lines ​

  • CLI: --coverage.watermarks.lines <watermarks>

Limites superior e inferior para linhas no formato de <superior>,<inferior>.

coverage.watermarks.branches ​

  • CLI: --coverage.watermarks.branches <watermarks>

Limites superior e inferior para branches no formato de <superior>,<inferior>.

coverage.watermarks.functions ​

  • CLI: --coverage.watermarks.functions <watermarks>

Limites superior e inferior para funções no formato de <superior>,<inferior>.

mode ​

  • CLI: --mode <name>
  • Config: mode

Define o modo Vite (padrão: test ou benchmark).

workspace ​

Caminho para um arquivo de configuração de workspace.

isolate ​

Executa cada arquivo de teste isoladamente. Para desabilitar o isolamento, use --no-isolate (padrão: true).

globals ​

Injeta APIs globalmente.

dom ​

  • CLI: --dom

Simula APIs de navegador usando happy-dom.

browser.enabled ​

Executa testes no navegador. Equivalente a --browser.enabled (padrão: false).

browser.name ​

Executa todos os testes em um navegador específico. Alguns navegadores estão disponíveis apenas para provedores específicos (consulte --browser.provider). Consulte browser.name para mais informações.

browser.headless ​

Executa o navegador em modo headless (sem interface gráfica do usuário). Se você estiver executando o Vitest em CI, ele será habilitado por padrão (padrão: process.env.CI).

browser.api.port ​

Especifica a porta do servidor. Se a porta já estiver em uso, o Vite tentará automaticamente a próxima porta disponível, o que significa que esta pode não ser a porta real em que o servidor acabará escutando. Se true, será definida como 63315.

browser.api.host ​

Especifica em quais endereços IP o servidor deve escutar. Defina como 0.0.0.0 ou true para escutar em todos os endereços, incluindo LAN e endereços públicos.

browser.api.strictPort ​

Se true, o Vitest será encerrado se a porta já estiver em uso, em vez de tentar automaticamente a próxima porta disponível.

browser.provider ​

Provedor usado para executar testes de navegador. Alguns navegadores estão disponíveis apenas para provedores específicos. Pode ser "webdriverio", "playwright", "preview" ou o caminho para um provedor personalizado. Consulte browser.provider para mais informações (padrão: "preview").

browser.providerOptions ​

Opções que são passadas para um provedor de navegador. Consulte browser.providerOptions para mais informações.

browser.isolate ​

Executa cada arquivo de teste do navegador isoladamente. Para desabilitar o isolamento, use --browser.isolate=false (padrão: true).

browser.ui ​

Exibe a UI do Vitest ao executar testes (padrão: !process.env.CI).

browser.fileParallelism ​

Define se os arquivos de teste do navegador devem ser executados em paralelo. Use --browser.fileParallelism=false para desabilitar (padrão: true).

pool ​

  • CLI: --pool <pool>
  • Config: pool

Especifica o pool de execução, se não estiver executando no navegador (padrão: threads).

poolOptions.threads.isolate ​

Isola testes no pool de threads (padrão: true).

poolOptions.threads.singleThread ​

Executa testes em uma única thread (padrão: false).

poolOptions.threads.maxThreads ​

Número máximo ou porcentagem de threads para executar os testes.

poolOptions.threads.minThreads ​

Número mínimo ou porcentagem de threads para executar os testes.

poolOptions.threads.useAtomics ​

Usa Atomics para sincronizar threads. Isso pode melhorar o desempenho em alguns casos, mas pode causar segfault em versões mais antigas do Node (padrão: false).

poolOptions.vmThreads.isolate ​

Isola testes no pool de threads VM (padrão: true).

poolOptions.vmThreads.singleThread ​

Executa testes em uma única thread VM (padrão: false).

poolOptions.vmThreads.maxThreads ​

Número máximo ou porcentagem de threads VM para executar os testes.

poolOptions.vmThreads.minThreads ​

Número mínimo ou porcentagem de threads VM para executar os testes.

poolOptions.vmThreads.useAtomics ​

Usa Atomics para sincronizar threads VM. Isso pode melhorar o desempenho em alguns casos, mas pode causar segfault em versões mais antigas do Node (padrão: false).

poolOptions.vmThreads.memoryLimit ​

Limite de memória para o pool de threads VM. Se você notar vazamentos de memória, tente ajustar este valor.

poolOptions.forks.isolate ​

Isola testes no pool de forks (padrão: true).

poolOptions.forks.singleFork ​

Executa testes em um único processo filho (fork) (padrão: false).

poolOptions.forks.maxForks ​

Número máximo ou porcentagem de processos (forks) para executar os testes.

poolOptions.forks.minForks ​

Número mínimo ou porcentagem de processos (forks) para executar os testes.

poolOptions.vmForks.isolate ​

Isola testes no pool de forks VM (padrão: true).

poolOptions.vmForks.singleFork ​

Executa testes em um único processo filho VM (fork) (padrão: false).

poolOptions.vmForks.maxForks ​

Número máximo ou porcentagem de processos VM (forks) para executar os testes.

poolOptions.vmForks.minForks ​

Número mínimo ou porcentagem de processos VM (forks) para executar os testes.

poolOptions.vmForks.memoryLimit ​

Limite de memória para o pool de forks VM. Se você notar vazamentos de memória, tente ajustar este valor.

fileParallelism ​

Define se todos os arquivos de teste devem ser executados em paralelo. Use --no-file-parallelism para desabilitar (padrão: true).

maxWorkers ​

Número máximo ou porcentagem de workers para executar testes.

minWorkers ​

Número mínimo ou porcentagem de workers para executar testes.

environment ​

Especifica o ambiente do executor, se não estiver executando no navegador (padrão: node).

passWithNoTests ​

Considera a execução bem-sucedida mesmo quando nenhum teste é encontrado.

logHeapUsage ​

Exibe o tamanho da heap para cada teste ao executar no Node.

allowOnly ​

Permite testes e suítes que estão marcados como "only" (padrão: !process.env.CI).

dangerouslyIgnoreUnhandledErrors ​

Ignora quaisquer erros não tratados que ocorram.

sequence.shuffle.files ​

Executa arquivos em ordem aleatória. Testes de longa duração não começarão antes se você habilitar esta opção (padrão: false).

sequence.shuffle.tests ​

Executa testes em ordem aleatória (padrão: false).

sequence.concurrent ​

Executa testes em paralelo (padrão: false).

sequence.seed ​

Define a semente de randomização. Esta opção não terá efeito se --sequence.shuffle estiver desabilitado. Consulte a página "Random Seed" para mais informações.

sequence.hooks ​

Altera a ordem em que os hooks são executados. Os valores aceitos são: "stack", "list" e "parallel". Consulte sequence.hooks para mais informações (padrão: "parallel").

sequence.setupFiles ​

Altera a ordem em que os arquivos de configuração são executados. Os valores aceitos são: "list" e "parallel". Se definido como "list", executará os arquivos de configuração na ordem em que são definidos. Se definido como "parallel", executará os arquivos de configuração em paralelo (padrão: "parallel").

inspect ​

  • CLI: --inspect [[host:]port]
  • Config: inspect

Habilita o inspetor do Node.js (padrão: 127.0.0.1:9229).

inspectBrk ​

Habilita o inspetor do Node.js e pausa antes do teste começar.

testTimeout ​

Tempo limite padrão de um teste em milissegundos (padrão: 5000).

hookTimeout ​

Tempo limite padrão do hook em milissegundos (padrão: 10000).

bail ​

  • CLI: --bail <number>
  • Config: bail

Para a execução do teste quando o número especificado de testes falhar (padrão: 0).

retry ​

  • CLI: --retry <times>
  • Config: retry

Repete o teste um número específico de vezes se ele falhar (padrão: 0).

diff ​

  • CLI: --diff <path>
  • Config: diff

Caminho para uma configuração de diff que será usada para gerar a interface de diff.

exclude ​

  • CLI: --exclude <glob>
  • Config: exclude

Padrões glob de arquivos adicionais a serem excluídos do teste.

expandSnapshotDiff ​

Exibe o diff completo quando um snapshot falha.

disableConsoleIntercept ​

Desabilita a interceptação automática de logs do console (padrão: false).

typecheck.enabled ​

Ativa a verificação de tipos durante os testes (padrão: false).

typecheck.only ​

Executa apenas testes de verificação de tipo. Isso habilita automaticamente a verificação de tipo (padrão: false).

typecheck.checker ​

Especifica o verificador de tipo a ser usado. Os valores disponíveis são: "tsc", "vue-tsc" e um caminho para um executável (padrão: "tsc").

typecheck.allowJs ​

Permite a verificação de tipos em arquivos JavaScript. Por padrão, assume o valor de tsconfig.json.

typecheck.ignoreSourceErrors ​

Ignora erros de tipo de arquivos de origem.

typecheck.tsconfig ​

Caminho para um arquivo tsconfig personalizado.

project ​

  • CLI: --project <name>
  • Config: project

O nome do projeto a ser executado se você estiver usando o recurso de workspace do Vitest. Isso pode ser repetido para vários projetos: --project=1 --project=2. Você também pode filtrar projetos usando curingas como --project=packages*.

slowTestThreshold ​

Limite em milissegundos para um teste ser considerado lento (padrão: 300).

teardownTimeout ​

Tempo limite padrão de uma função de teardown em milissegundos (padrão: 10000).

maxConcurrency ​

Número máximo de testes concorrentes em uma suíte (padrão: 5).

expect.requireAssertions ​

Exige que todos os testes tenham pelo menos uma asserção.

expect.poll.interval ​

Intervalo de polling em milissegundos para asserções expect.poll() (padrão: 50).

expect.poll.timeout ​

Tempo limite de polling em milissegundos para asserções expect.poll() (padrão: 1000).

printConsoleTrace ​

Sempre imprime rastreamentos de pilha do console.

run ​

  • CLI: --run

Desabilita o modo de observação.

color ​

  • CLI: --no-color

Remove cores da saída do console.

clearScreen ​

  • CLI: --clearScreen

Limpa a tela do terminal ao reexecutar testes durante o modo de observação (padrão: true).

standalone ​

  • CLI: --standalone

Inicia o Vitest sem rodar testes imediatamente. Os filtros de arquivo serão ignorados, e os testes serão executados apenas quando houver alterações (padrão: false).

Distribuído sob a Licença MIT.

Copyright (c) 2021-Present Vitest Team

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

Distribuído sob a Licença MIT.

Copyright (c) 2021-Present Vitest Team