Vue d’ensemble de l’exécution de tests

Pour exécuter des tests à l’aide de TAEF, vous spécifiez les fichiers de test avec la commande TE.EXE, dont le chemin d'accès est le suivant : % :\Program Files (x86)\Windows Kits\10\Testing\Runtimes\TAEF. Par exemple, pour exécuter tous les tests dans le fichier de test CPP.Basic.Examples.dll, exécutez :

TE.exe CPP.Basic.Examples.dll

Vous pouvez spécifier plusieurs fichiers de test, même s’ils contiennent des tests balisés de manière différente. Par exemple, la commande suivante exécute tous les tests dans les fichiers CPP.Basic.Examples.dll et CSharp.Basic.Examples.dll fichiers, même s’ils sont écrits dans différentes langues :

TE.exe CPP.Basic.Examples.dll CSharp.Basic.Examples.dll

Vous pouvez également utiliser des caractères génériques carte pour choisir les fichiers à exécuter :

TE.exe *.Examples.dll

Vous pouvez également spécifier des chemins relatifs :

TE.exe Examples\*

Si un fichier est spécifié à l’invite de commandes qui ne contient aucun test, TE.exe signale un message d’erreur.

Ordre d'exécution

Les fichiers de test spécifiés à l’invite de commandes seront traités dans l’ordre dans lequel ils sont spécifiés.

Exécution hors du processus

Par défaut, TAEF exécute des tests hors processus. TAEF utilise le processus TE.ProcessHost.exe pour exécuter les tests. Ainsi les tests sont isolés les uns des autres, ce qui les empêche d’être affectés par des tests antérieurs. Pour exécuter des tests dans le processus TE.exe, spécifiez l’option /inproc pour TE.exe.

Sélection des tests

Vous pouvez sélectionner des tests spécifiques à l’aide de l’option /select et en spécifiant une « demande de sélection ». Si vous souhaitez sélectionner en fonction uniquement du nom du test, utilisez plutôt l’option /name. Pour en savoir plus sur l’utilisation de la demande de sélection pour sélectionner des tests spécifiques à exécuter, consultez Sélection.

Spécification d’une partie de la commande en tant que variable d’environnement : te_cmd

Si certaines de vos options de commande pour te.exe seront toujours identiques, vous pouvez tirer parti de la variable d’environnement te_cmd. Quelle que soit la valeur de te_cmd, elle sera ajoutée à la commande pour l'exécution de te.exe. Avec set te_cmd=/list, vous verrez toujours la liste des tests en regard de l'exécution pour les binaires spécifiés à l'invite de commande.

Listage des tests

En spécifiant l’option de commande /list avec les fichiers de test, les noms des classes et des méthodes de test dans les fichiers de test seront listés sur la console. Il est à noter que cette commande ne fait que lister les noms des binaires, des classes et des méthodes de test pour chaque binaire spécifié et ne les exécute pas. Si vous souhaitez répertorier plus de détails, comme les méthodes de configuration et de nettoyage, les métadonnées ou les propriétés spécifiées à chaque niveau, et en cas de tests basés sur les données, les données fournies, utilisez l’option de commande /listproperties à la place.

Résultats du test

Pour tous les tests génériques, le résultat dépend de la réussite ou de l’échec des appels de vérification effectués. Vous trouverez les API disponibles et d’autres détails sur Vérifier. Si aucun appel de vérification n’est effectué pendant le test, le résultat est défini par défaut sur « Réussi » pour les abonnés au journal fournis avec TAEF. Vous pouvez choisir de spécifier explicitement un DefaultTestResult lors de la création du test. Pour en savoir plus, consultez Rédaction de tests.

Aide - Options de la commande

Recherchez des explications de toutes les options de commande disponibles en spécifiant l'option /? pour TE.exe. Pour obtenir des explications étendues, consultez Options de commande Te.exe.