Sortie du terminal

Le rapporteur de test de terminal est l’implémentation par défaut des rapports d’état et de progression au terminal (console). Il fait partie du cœur Microsoft. Testing.Platform (MTP) et ne nécessite aucun package NuGet supplémentaire.

Modes de sortie

MTP prend en charge ces modes de sortie :

• Minimal signale les blocs de résultats ayant échoué.

• Normal signale les blocs de résultats en échec et ignorés. Il contient également la bannière, les messages d’avertissement et le résumé de l’exécution.

• Detailed signale tous les blocs de résultats.

Minimal est disponible en préversion de MTP 2.4.

Institut national américain des normes (ANSI)

En interne, il existe 2 formateurs de sortie différents qui détectent automatiquement la fonctionnalité de terminal pour gérer les codes d’échappement ANSI.

• Le formateur ANSI est utilisé lorsque le terminal est capable de restituer les codes d’échappement.
• Le formateur non ANSI est utilisé lorsque le terminal ne peut pas gérer les codes d’échappement, lorsqu’il --no-ansi est utilisé ou lorsque la sortie est redirigée.

La valeur par défaut consiste à détecter automatiquement les fonctionnalités.

Progrès

Un indicateur de progression est écrit dans le terminal. L’indicateur de progression indique le nombre de tests réussis, les tests ayant échoué et les tests ignorés, suivis du nom de l’assembly testé, de son infrastructure cible et de son architecture.

La barre de progression est écrite en fonction du mode sélectionné :

• ANSI, la barre de progression est animée, collant au bas de l’écran et est actualisée toutes les 500 ms. La barre de progression se masque une fois l'exécution du test terminée.
• non-ANSI, la barre de progression est inscrite à l’écran telle quelle toutes les 3 secondes. Les progrès se reflètent dans les résultats.

Sortie directe sur la console et réaffichage de la progression

Pour animer la barre de progression, le convertisseur de progression ANSI prend le contrôle du curseur de terminal et redessine à plusieurs reprises le bas de l’écran. Tout texte écrit directement dans stdout ou stderr en dehors du chemin de capture de l’infrastructure de test peut être remplacé ou supprimé pendant ce redessinage. Par exemple, un appel à Console.WriteLine depuis le code du cycle de vie au niveau de l’assembly ou de la session (comme un hook Before(Assembly) ou Before(TestSession)), ou depuis une extension, peut clignoter brièvement, puis disparaître lorsque la barre de progression se met à jour.

Ce comportement est distinct de la sortie standard capturée par test et de l’erreur standard. La sortie qu’un test génère pendant son exécution est capturée par le framework et affichée en fonction de --show-stdout et --show-stderr, afin que la barre de progression ne l’écrase pas.

Si votre code doit écrire directement dans la console et que vous avez besoin de cette sortie pour rester visible, désactivez la progression (--progress off dans MTP 2.3.0+, ou --no-progress dans les versions antérieures). Vous pouvez également désactiver ANSI (--ansi off dans MTP 2.3.0+, ou --no-ansi dans les versions antérieures) pour utiliser la sortie de progression non ANSI, qui ajoute de nouvelles lignes au lieu de redessiner en place et ne remplace pas la sortie directe précédente.

Options

Choix	Version MTP	Descriptif
--no-progress	—	Désactive l’affichage de la progression à l’écran. Déconseillé dans MTP 2.3.0 en faveur de --progress off.
--progress	2.3.0	Contrôle si la progression est affichée. Les valeurs valides sont auto (valeur par défaut), on (accepte trueégalement, enable1, et off (accepte falseégalement , ). disable0
--no-ansi	—	Désactive l’affichage des caractères d’échappement ANSI à l’écran.
--ansi	2.3.0	Contrôle si les caractères d’échappement ANSI sont émis. Les valeurs valides sont auto (valeur par défaut), on (accepte trueégalement, enable1, et off (accepte falseégalement , ). disable0
--output	—	Spécifie le niveau de détail de la sortie pour les résultats des tests. Les valeurs valides sont Minimal, Normalet Detailed. La valeur par défaut est Normal. Minimal nécessite la préversion de MTP 2.4.
--show-test-results <OUTCOME>	2.4.0	Sélectionne les blocs de résultats par résultat. Utilisez passed, , failed, skipped, allou none. failed inclut également les erreurs, les délais d’expiration et les annulations.
--show-stdout	2.2.1	Détermine quand afficher la sortie standard capturée d’un test. Les valeurs valides sont All, Failedet None. La valeur par défaut est All.
--show-stderr	2.2.1	Détermine quand afficher la sortie d’erreur capturée d’un test. Les valeurs valides sont All, Failedet None. La valeur par défaut est All.
--show-flaky-tests	2.4.0	Contrôle le résumé et la flaky: liste des tests Flaky pour les tests qui réussissent après une nouvelle tentative. Utilisez on ou off; la valeur par défaut est on. S’applique à MSTest [Retry] et à l’extension de réexécution.
--show-slowest-tests	2.4.0	Affiche le nombre demandé de tests les plus lents dans le résumé. Pour une exécution multimodèle, MTP signale les tests les plus lents pour chaque module.

Combinez passed, failedet skipped avec des virgules, des espaces ou des options répétées --show-test-results . N’associez pas all ou none à une autre valeur. Une valeur explicite --show-test-results remplace la présélection, quel que soit l’ordre --output d’option. Le filtre modifie les blocs de résultats uniquement ; les nombres de progression et de résumé restent inchangés.

Note

Un tiret (—) dans la colonne de version MTP marque les options principales qui ne sont pas liées à une version spécifique, car elles ont été disponibles depuis les versions initiales de la plateforme.

Note

À partir de MTP 2.3.0, lorsque MTP détecte qu’il s’exécute dans un environnement d’outil LLM ou d’IA, il supprime la bannière de démarrage et modifie la valeur par défaut de --show-stdout et de --show-stderr de All à Failed afin de réduire le bruit.