Rapports de test

Ces fonctionnalités nécessitent l’installation de packages NuGet supplémentaires, comme décrit dans chaque section.

Conseil / Astuce

Lors de l’utilisation de Microsoft.Testing.Platform.MSBuild (inclus transitivement par MSTest, NUnit et xUnit Runners), ces extensions sont enregistrées automatiquement lorsque vous installez leurs packages NuGet, sans modification du code nécessaire. L’inscription manuelle spécifiée dans cet article n’est requise que si vous avez désactivé le point d’entrée généré automatiquement en définissant <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

rapports de test Visual Studio (TRX)

Le Visual Studio fichier de résultats de test (ou TRX) est le format par défaut pour la publication des résultats des tests. Cette extension nécessite le package NuGet Microsoft.Testing.Extensions.TrxReport .

Inscription manuelle

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddTrxReportProvider();

Note

Lors de l’utilisation de l’inscription manuelle, inscrivez le fournisseur de rapports TRX en dernier. L’implémentation actuelle dépend de l’ordre d’inscription. Par conséquent, l’inscription après toutes les autres extensions garantit qu’elle capture toutes les données de test.

Options

Choix Descriptif
--report-trx Génère le rapport TRX.
--report-trx-filename Nom du rapport TRX généré. Le nom par défaut correspond au format <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trxsuivant.

Le rapport est enregistré dans le dossier TestResults par défaut qui peut être spécifié via l’argument --results-directory de ligne de commande.

rapports Azure DevOps

Azure DevOps plug-in de rapport améliore l’exécution des tests pour les développeurs qui hébergent leur code sur GitHub, mais s’appuient sur des agents de build Azure DevOps. Il ajoute des informations supplémentaires aux échecs pour afficher un échec directement dans une pull request GitHub.

Annotation d'erreur dans la vue des fichiers de PR sur GitHub

Cette extension nécessite le package NuGet Microsoft.Testing.Extensions.AzureDevOpsReport .

Inscription manuelle

var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHost.AddAzureDevOpsProvider();

Options

Choix Descriptif
--report-azdo Active le générateur de rapports Azure DevOps. Les erreurs et les avertissements sont écrits dans la sortie dans un format que Azure DevOps comprend.
--report-azdo-severity Gravité à utiliser pour les événements signalés. Les valeurs valides sont error (par défaut) et warning.
--report-azdo-flaky-history Interroge l’historique des résultats de test d’Azure DevOps des N derniers jours (1 à 90) et annote les échecs signalés avec un contexte sur leur instabilité. Exige --report-azdo.
--report-azdo-demote-known-flaky Abaisse du statut d’erreur à celui d’avertissement les échecs suffisamment instables dans la fenêtre d’historique d’Azure DevOps (le seuil par défaut est de 25 %). Nécessite --report-azdo et --report-azdo-flaky-history.
--report-azdo-quarantine-file Chemin d’accès à un fichier texte qui répertorie les noms complets de test mis en quarantaine ou les modèles glob. Les échecs correspondants sont signalés en tant qu’avertissements. Exige --report-azdo.
--report-azdo-upload-artifacts Charge les fichiers de résultats de test et/ou ajoute des balises de build à Azure DevOps. Les valeurs valides sont off (par défaut), tags-only, fileset all.
--report-azdo-upload-artifact-include Inclut des fichiers dans le chargement d’artefacts Azure DevOps à l’aide de modèles glob par rapport au répertoire des résultats des tests. La valeur par défaut est **/*. Doit --report-azdo-upload-artifacts être une valeur autre que off.
--report-azdo-upload-artifact-exclude Exclut les fichiers du chargement d’artefacts Azure DevOps à l’aide de modèles glob par rapport au répertoire des résultats des tests. Doit --report-azdo-upload-artifacts être une valeur autre que off.
--report-azdo-upload-artifact-name Remplace le nom du conteneur d’artefacts Azure DevOps. La valeur par défaut est TestResults_{assemblyName}_{tfm}. Doit --report-azdo-upload-artifacts être une valeur autre que off.
--publish-azdo-test-results Publie les résultats des tests en direct sous l’onglet Azure DevOps Tests.
--publish-azdo-run-name Définit un nom d’exécution de test Azure DevOps personnalisé pour la publication de résultats de test en direct. Exige --publish-azdo-test-results.

Note

L’extension Azure DevOps est devenue stable dans MTP 1.9.0 (--report-azdo et --report-azdo-severity). Toutes les autres options du tableau ( --report-azdo-flaky-history, , --report-azdo-demote-known-flaky--report-azdo-quarantine-file, --report-azdo-upload-artifacts--report-azdo-upload-artifact-include--report-azdo-upload-artifact-exclude, , --report-azdo-upload-artifact-name, , --publish-azdo-test-resultset --publish-azdo-run-name ) sont disponibles dans MTP à partir de la version 2.3.0.

L’extension détecte automatiquement qu’elle s’exécute dans un environnement d’intégration continue (CI) en vérifiant la TF_BUILD variable d’environnement.

  • Last updated on