Vitest 2

Français

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

Français

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

Apparence

root ​

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

Répertoire racine du projet.

config ​

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

Chemin vers le fichier de configuration de Vitest.

update ​

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

Met à jour les instantanés (snapshots).

watch ​

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

Active le mode de surveillance (watch mode).

testNamePattern ​

Exécute les tests dont les noms complets correspondent au motif d'expression régulière spécifié.

dir ​

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

Répertoire de base à scanner pour les fichiers de test.

ui ​

  • CLI: --ui
  • Config: ui

Active l'interface utilisateur (UI) de Vitest.

open ​

  • CLI: --open
  • Config: open

Ouvre automatiquement l'interface utilisateur (par défaut : !process.env.CI).

api.port ​

  • CLI: --api.port [port]

Spécifie le port du serveur API. Si le port est déjà utilisé, Vite essaiera automatiquement le prochain port disponible. Si la valeur est true, le port sera défini à 51204.

api.host ​

  • CLI: --api.host [host]

Spécifie les adresses IP sur lesquelles le serveur API doit écouter. Définissez ceci à 0.0.0.0 ou true pour écouter sur toutes les adresses, y compris les adresses LAN et publiques.

api.strictPort ​

  • CLI: --api.strictPort

Si true, quitte si le port est déjà utilisé, au lieu d'essayer automatiquement le prochain port disponible.

silent ​

Rend la sortie console des tests silencieuse.

hideSkippedTests ​

  • CLI: --hideSkippedTests

Masque les logs des tests ignorés.

reporters ​

Spécifie les reporters à utiliser.

outputFile ​

Écrit les résultats des tests dans un fichier lorsque le reporter pris en charge est également spécifié. Utilisez la notation par points pour les sorties individuelles de plusieurs reporters (exemple : --outputFile.tap=./tap.txt).

coverage.all ​

Indique si tous les fichiers, y compris ceux non testés, doivent être inclus dans le rapport de couverture.

coverage.provider ​

Sélectionne l'outil de collecte de couverture. Les valeurs disponibles sont : "v8", "istanbul" et "custom".

coverage.enabled ​

Active la collecte de couverture. Peut être remplacé par l'option CLI --coverage (par défaut : false).

coverage.include ​

Fichiers à inclure dans la couverture sous forme de motifs globaux. Peut être spécifié plusieurs fois lors de l'utilisation de plusieurs motifs (par défaut : **).

coverage.exclude ​

Fichiers à exclure de la couverture. Peut être spécifié plusieurs fois lors de l'utilisation de plusieurs motifs (par défaut : voir coverage.exclude).

coverage.extension ​

Extensions de fichiers à inclure dans la couverture. Peut être spécifiée plusieurs fois lors de l'utilisation de plusieurs extensions (par défaut : [".js", ".cjs", ".mjs", ".ts", ".mts", ".tsx", ".jsx", ".vue", ".svelte"]).

coverage.clean ​

Nettoie les résultats de couverture avant d'exécuter les tests (par défaut : true).

coverage.cleanOnRerun ​

Nettoie le rapport de couverture lors d'une réexécution en mode surveillance (par défaut : true).

coverage.reportsDirectory ​

Répertoire où écrire le rapport de couverture (par défaut : ./coverage).

coverage.reporter ​

Reporters de couverture à utiliser. Visitez coverage.reporter pour plus d'informations (par défaut : ["text", "html", "clover", "json"]).

coverage.reportOnFailure ​

Génère un rapport de couverture même si les tests échouent (par défaut : false).

coverage.allowExternal ​

Collecte la couverture des fichiers en dehors de la racine du projet (par défaut : false).

coverage.skipFull ​

Ne pas afficher les fichiers avec une couverture de 100 % des instructions, des branches et des fonctions (par défaut : false).

coverage.thresholds.100 ​

Raccourci pour définir tous les seuils de couverture à 100 % (par défaut : false).

coverage.thresholds.perFile ​

Vérifie les seuils par fichier. Voir --coverage.thresholds.lines, --coverage.thresholds.functions, --coverage.thresholds.branches et --coverage.thresholds.statements pour les seuils réels (par défaut : false).

coverage.thresholds.autoUpdate ​

Met à jour les valeurs de seuil ("lines", "functions", "branches" et "statements") dans le fichier de configuration lorsque la couverture actuelle est supérieure aux seuils configurés (par défaut : false).

coverage.thresholds.lines ​

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

Seuil minimal de couverture pour les lignes. Visitez istanbuljs pour plus d'informations. Cette option n'est pas disponible pour les fournisseurs personnalisés.

coverage.thresholds.functions ​

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

Seuil minimal de couverture pour les fonctions. Visitez istanbuljs pour plus d'informations. Cette option n'est pas disponible pour les fournisseurs personnalisés.

coverage.thresholds.branches ​

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

Seuil minimal de couverture pour les branches. Visitez istanbuljs pour plus d'informations. Cette option n'est pas disponible pour les fournisseurs personnalisés.

coverage.thresholds.statements ​

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

Seuil minimal de couverture pour les instructions. Visitez istanbuljs pour plus d'informations. Cette option n'est pas disponible pour les fournisseurs personnalisés.

coverage.ignoreClassMethods ​

Tableau des noms de méthodes de classe à ignorer pour la couverture. Visitez istanbuljs pour plus d'informations. Cette option est uniquement disponible pour les fournisseurs Istanbul (par défaut : []).

coverage.processingConcurrency ​

Limite de concurrence utilisée lors du traitement des résultats de couverture (par défaut : le minimum entre 20 et le nombre de CPU).

coverage.customProviderModule ​

Spécifie le nom ou le chemin du module pour le fournisseur de couverture personnalisé. Visitez Custom Coverage Provider pour plus d'informations. Cette option est uniquement disponible pour les fournisseurs personnalisés.

coverage.watermarks.statements ​

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

Seuils haut et bas pour les instructions au format <haut>,<bas>.

coverage.watermarks.lines ​

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

Seuils haut et bas pour les lignes au format <haut>,<bas>.

coverage.watermarks.branches ​

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

Seuils haut et bas pour les branches au format <haut>,<bas>.

coverage.watermarks.functions ​

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

Seuils haut et bas pour les fonctions au format <haut>,<bas>.

mode ​

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

Outrepasse le mode Vite (par défaut : test ou benchmark).

workspace ​

Chemin vers un fichier de configuration d'espace de travail.

isolate ​

Exécute chaque fichier de test en isolation. Pour désactiver l'isolation, utilisez --no-isolate (par défaut : true).

globals ​

Injecte les API de Vitest globalement.

dom ​

  • CLI: --dom

Émule l'API du navigateur avec happy-dom.

browser.enabled ​

Exécute les tests dans le navigateur (par défaut : false).

browser.name ​

Exécute tous les tests dans un navigateur spécifique. Certains navigateurs ne sont disponibles que pour des fournisseurs spécifiques (voir --browser.provider). Visitez browser.name pour plus d'informations.

browser.headless ​

Exécute le navigateur en mode sans tête (c'est-à-dire sans ouvrir l'interface utilisateur graphique). Si Vitest est exécuté en CI, ce mode est activé par défaut (par défaut : process.env.CI).

browser.api.port ​

Spécifie le port du serveur API du navigateur. Si le port est déjà utilisé, Vite essaiera automatiquement le prochain port disponible, ce qui signifie que ce n'est peut-être pas le port réel sur lequel le serveur écoute. Si la valeur est true, le port sera défini à 63315.

browser.api.host ​

Spécifie les adresses IP sur lesquelles le serveur API du navigateur doit écouter. Définissez ceci à 0.0.0.0 ou true pour écouter sur toutes les adresses, y compris les adresses LAN et publiques.

browser.api.strictPort ​

Si true, quitte si le port est déjà utilisé, au lieu d'essayer automatiquement le prochain port disponible.

browser.provider ​

Fournisseur utilisé pour exécuter les tests de navigateur. Certains navigateurs ne sont disponibles que pour des fournisseurs spécifiques. Peut être "webdriverio", "playwright", "preview", ou le chemin vers un fournisseur personnalisé. Visitez browser.provider pour plus d'informations (par défaut : "preview").

browser.providerOptions ​

Options passées à un fournisseur de navigateur. Visitez browser.providerOptions pour plus d'informations.

browser.isolate ​

Exécute chaque fichier de test de navigateur en isolation. Pour désactiver l'isolation, utilisez --browser.isolate=false (par défaut : true).

browser.ui ​

Affiche l'interface utilisateur de Vitest lors de l'exécution des tests (par défaut : !process.env.CI).

browser.fileParallelism ​

Indique si les fichiers de test de navigateur doivent s'exécuter en parallèle. Utilisez --browser.fileParallelism=false pour désactiver (par défaut : true).

pool ​

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

Spécifie le pool d'exécution, si les tests ne sont pas exécutés dans le navigateur (par défaut : threads).

poolOptions.threads.isolate ​

Isole les tests dans le pool de threads (par défaut : true).

poolOptions.threads.singleThread ​

Exécute les tests dans un seul thread (par défaut : false).

poolOptions.threads.maxThreads ​

Nombre maximal ou pourcentage de threads pour exécuter les tests.

poolOptions.threads.minThreads ​

Nombre minimal ou pourcentage de threads pour exécuter les tests.

poolOptions.threads.useAtomics ​

Utilise les Atomics pour synchroniser les threads. Cela peut améliorer les performances dans certains cas, mais peut provoquer des erreurs de segmentation dans les anciennes versions de Node (par défaut : false).

poolOptions.vmThreads.isolate ​

Isole les tests dans le pool de threads VM (par défaut : true).

poolOptions.vmThreads.singleThread ​

Exécute les tests dans un seul thread VM (par défaut : false).

poolOptions.vmThreads.maxThreads ​

Nombre maximal ou pourcentage de threads VM pour exécuter les tests.

poolOptions.vmThreads.minThreads ​

Nombre minimal ou pourcentage de threads VM pour exécuter les tests.

poolOptions.vmThreads.useAtomics ​

Utilise les Atomics pour synchroniser les threads VM. Cela peut améliorer les performances dans certains cas, mais peut provoquer des erreurs de segmentation dans les anciennes versions de Node (par défaut : false).

poolOptions.vmThreads.memoryLimit ​

Limite de mémoire pour le pool de threads VM. Si vous constatez des fuites de mémoire, essayez de modifier cette valeur.

poolOptions.forks.isolate ​

Isole les tests dans le pool de forks (par défaut : true).

poolOptions.forks.singleFork ​

Exécute les tests dans un processus enfant unique (par défaut : false).

poolOptions.forks.maxForks ​

Nombre maximal ou pourcentage de processus pour exécuter les tests.

poolOptions.forks.minForks ​

Nombre minimal ou pourcentage de processus pour exécuter les tests.

poolOptions.vmForks.isolate ​

Isole les tests dans le pool de forks VM (par défaut : true).

poolOptions.vmForks.singleFork ​

Exécute les tests dans un processus enfant unique VM (par défaut : false).

poolOptions.vmForks.maxForks ​

Nombre maximal ou pourcentage de processus VM pour exécuter les tests.

poolOptions.vmForks.minForks ​

Nombre minimal ou pourcentage de processus VM pour exécuter les tests.

poolOptions.vmForks.memoryLimit ​

Limite de mémoire pour le pool de forks VM. Si vous constatez des fuites de mémoire, essayez de modifier cette valeur.

fileParallelism ​

Indique si tous les fichiers de test doivent s'exécuter en parallèle. Utilisez --no-file-parallelism pour désactiver (par défaut : true).

maxWorkers ​

Nombre maximal ou pourcentage de workers pour exécuter les tests.

minWorkers ​

Nombre minimal ou pourcentage de workers pour exécuter les tests.

environment ​

Spécifie l'environnement d'exécution, si les tests ne sont pas exécutés dans le navigateur (par défaut : node).

passWithNoTests ​

Indique que l'exécution doit réussir si aucun test n'est trouvé.

logHeapUsage ​

Affiche la taille du tas pour chaque test lors de l'exécution dans Node.

allowOnly ​

Autorise l'exécution des tests et des suites marqués comme "only" (par défaut : !process.env.CI).

dangerouslyIgnoreUnhandledErrors ​

Ignore toutes les erreurs non gérées qui se produisent.

sequence.shuffle.files ​

Exécute les fichiers dans un ordre aléatoire. Les tests longs ne démarreront pas plus tôt si vous activez cette option (par défaut : false).

sequence.shuffle.tests ​

Exécute les tests dans un ordre aléatoire (par défaut : false).

sequence.concurrent ​

Permet aux tests de s'exécuter en parallèle (par défaut : false).

sequence.seed ​

Définit la graine aléatoire. Cette option n'aura aucun effet si --sequence.shuffle est désactivé. Visitez la page "Random Seed" pour plus d'informations.

sequence.hooks ​

Modifie l'ordre dans lequel les hooks sont exécutés. Les valeurs acceptées sont : "stack", "list" et "parallel". Visitez sequence.hooks pour plus d'informations (par défaut : "parallel").

sequence.setupFiles ​

Modifie l'ordre dans lequel les fichiers de configuration sont exécutés. Les valeurs acceptées sont : "list" et "parallel". Si défini à "list", exécutera les fichiers de configuration dans l'ordre où ils sont définis. Si défini à "parallel", exécutera les fichiers de configuration en parallèle (par défaut : "parallel").

inspect ​

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

Active l'inspecteur Node.js (par défaut : 127.0.0.1:9229).

inspectBrk ​

Active l'inspecteur Node.js et s'arrête avant le début du test.

testTimeout ​

Délai d'attente par défaut d'un test en millisecondes (par défaut : 5000).

hookTimeout ​

Délai d'attente par défaut d'un hook en millisecondes (par défaut : 10000).

bail ​

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

Arrête l'exécution des tests lorsque le nombre spécifié de tests a échoué (par défaut : 0).

retry ​

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

Relance le test un nombre spécifié de fois s'il échoue (par défaut : 0).

diff ​

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

Chemin vers une configuration de diff qui sera utilisée pour générer l'interface de diff.

exclude ​

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

Motifs globaux de fichiers supplémentaires à exclure des tests.

expandSnapshotDiff ​

Affiche le diff complet lorsque l'instantané échoue.

disableConsoleIntercept ​

Désactive l'interception automatique des logs console (par défaut : false).

typecheck.enabled ​

Active la vérification de type en même temps que les tests (par défaut : false).

typecheck.only ​

Exécute uniquement les tests de vérification de type. Cela active automatiquement la vérification de type (par défaut : false).

typecheck.checker ​

Spécifie le vérificateur de type à utiliser. Les valeurs disponibles sont : "tsc", "vue-tsc" et un chemin vers un exécutable (par défaut : "tsc").

typecheck.allowJs ​

Autorise la vérification de type pour les fichiers JavaScript. Par défaut, prend la valeur de tsconfig.json.

typecheck.ignoreSourceErrors ​

Ignore les erreurs de type provenant des fichiers source.

typecheck.tsconfig ​

Chemin vers un fichier tsconfig personnalisé.

project ​

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

Le nom du projet à exécuter si vous utilisez la fonctionnalité d'espace de travail de Vitest. Cela peut être répété pour plusieurs projets : --project=1 --project=2. Vous pouvez également filtrer les projets en utilisant des caractères génériques comme --project=packages*.

slowTestThreshold ​

Seuil en millisecondes pour qu'un test soit considéré comme lent (par défaut : 300).

teardownTimeout ​

Délai d'attente par défaut d'une fonction de démontage en millisecondes (par défaut : 10000).

maxConcurrency ​

Nombre maximal de tests concurrents dans une suite (par défaut : 5).

expect.requireAssertions ​

Exige que tous les tests aient au moins une assertion.

expect.poll.interval ​

Intervalle de sondage en millisecondes pour les assertions expect.poll() (par défaut : 50 ms).

expect.poll.timeout ​

Délai d'attente de sondage en millisecondes pour les assertions expect.poll() (par défaut : 1000).

printConsoleTrace ​

Affiche toujours les traces de la console.

run ​

  • CLI: --run

Désactive le mode surveillance et exécute les tests une seule fois.

color ​

  • CLI: --no-color

Supprime les couleurs de la sortie console.

clearScreen ​

  • CLI: --clearScreen

Efface l'écran du terminal lors de la réexécution des tests en mode surveillance (par défaut : true).

standalone ​

  • CLI: --standalone

Démarre Vitest sans exécuter de tests immédiatement. Les filtres de fichiers seront ignorés, les tests ne seront exécutés qu'en cas de modification (par défaut : false).

Publié sous la licence MIT.

Copyright (c) 2021-Present Vitest Team

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

Publié sous la licence MIT.

Copyright (c) 2021-Present Vitest Team