Skip to content
Vitest 1
Main Navigation GuiaAPIConfiguraçãoAvançado
1.6.1
0.34.6

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

Sidebar Navigation

Guia

Por que Vitest

Primeiros Passos

Recursos

Workspace

Interface de Linha de Comando

Filtrando Testes

Reporters

Cobertura

Snapshot

Mocking

Testando Tipos

Vitest UI

Modo Navegador

Testes no Código Fonte

Contexto de Teste

Ambiente de Teste

Expandindo Matchers

Integrações de IDE

Depuração

Comparações com Outros Executores de Teste

Guia de Migração

Erros Comuns

Otimizando o Desempenho

API

Referência da API de Teste

Funções Mock

Vi

expect

expectTypeOf

assert

assertType

Configuração

Gerenciando o Arquivo de Configuração do Vitest

Configurando o Vitest

Nesta página

Gerenciando o Arquivo de Configuração do Vitest ​

Se você estiver usando o Vite e tiver um arquivo vite.config.js (ou .ts, etc.), o Vitest o lerá para integrar os plugins e a configuração do seu aplicativo Vite. Se você deseja uma configuração diferente para testes, ou se seu aplicativo principal não depende especificamente do Vite, você pode:

  • Criar um arquivo vitest.config.ts. Este arquivo terá prioridade e substituirá a configuração do vite.config.ts (o Vitest suporta todas as extensões convencionais de JS e TS, mas não suporta json). Isso significa que todas as opções em seu vite.config.ts serão ignoradas.
  • Passar a opção --config para a CLI. Por exemplo: vitest --config ./path/to/vitest.config.ts.
  • Usar process.env.VITEST ou a propriedade mode em defineConfig para aplicar condicionalmente configurações diferentes em vite.config.ts. A propriedade mode será definida como test/benchmark se não for explicitamente definida com --mode.

Para configurar o Vitest, adicione a propriedade test à sua configuração do Vite. Você também precisará adicionar uma referência aos tipos do Vitest usando um comando de barra tripla no topo do seu arquivo de configuração, caso esteja importando defineConfig diretamente do vite.

Ao usar defineConfig do vite, siga este exemplo:

ts
/// <reference types="vitest" />
import { defineConfig } from 'vite';

export default defineConfig({
  test: {
    // ... Especifique as opções desejadas aqui.
  },
});

Ao usar defineConfig do vitest/config, siga este exemplo:

ts
import { defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    // ... Especifique as opções desejadas aqui.
  },
});

Você pode obter as opções padrão do Vitest e estendê-las, se necessário:

ts
import { configDefaults, defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    exclude: [...configDefaults.exclude, 'packages/template/*'],
  },
});

Ao usar um arquivo vitest.config.js separado, você também pode estender as opções do Vite a partir de outro arquivo de configuração, se necessário:

ts
import { defineConfig, mergeConfig } from 'vitest/config';
import viteConfig from './vite.config';

export default mergeConfig(
  viteConfig,
  defineConfig({
    test: {
      exclude: ['packages/template/*'],
    },
  })
);

Se a sua configuração do Vite for definida como uma função, você pode defini-la da seguinte forma:

ts
import { defineConfig, mergeConfig } from 'vitest/config';
import viteConfig from './vite.config';

export default defineConfig(configEnv =>
  mergeConfig(
    viteConfig(configEnv),
    defineConfig({
      test: {
        exclude: ['packages/template/*'],
      },
    })
  )
);
Pager
AnteriorassertType
PróximoConfigurando o Vitest

Distribuído sob a Licença MIT.

Copyright (c) 2024 Mithril Contributors

https://v1.vitest.dev/config/file

Distribuído sob a Licença MIT.

Copyright (c) 2024 Mithril Contributors