LangueFrançais

Tests

Ouvrez Outils de l’espace de travail → Tests sur ordinateur ou Outils → Tests sur mobile, puis choisissez le projet. Tests lit les fichiers de test de votre projet comme du texte et affiche chaque test trouvé : dossiers, fichiers, noms des tests et code autour de chaque test. Cette lecture n’exécute, n’importe et n’installe jamais rien ; vos tests ne s’exécutent que lorsque vous choisissez de les lancer.

Le haut de la page présente un verdict d’une ligne et deux cartes. Tests unitaires et Tests de non-régression affichent chacune le nombre de tests réussis lors de leur dernière exécution, ce qui a échoué ou est instable, les exécutions récentes et un bouton Lancer. En dessous, une seule barre d’onglets réunit Tests unitaires, Tests de non-régression, Intégration et E2E, Vérifications (lint, types, compilation et scripts de vérification) et Historique.

Lire le verdict

La ligne placée au-dessus des cartes donne d’abord la réponse, d’après les derniers résultats de vos tests :

  • Pas encore vérifié tant qu’aucun test n’a été exécuté. Lancez vos tests une fois pour savoir où en est votre projet.
  • Quand des tests échouent, elle les compte et propose Voir les échecs : les tests en échec s’ouvrent avec le filtre Échec, en commençant par un test de non-régression lorsqu’un bug protégé réapparaît.
  • Quand des tests sont instables (ils ont échoué, puis réussi à une nouvelle tentative), elle les compte et propose Voir les tests instables.
  • Sinon, elle compte les tests qui réussissent, indique combien n’ont pas encore été lancés et quand la dernière exécution s’est terminée.

Les décomptes additionnent tests unitaires, tests d’intégration et de bout en bout, et vérifications. Les tests de non-régression réutilisent ces mêmes tests : ils ne sont pas comptés deux fois.

À côté du bouton Lancements automatiques, la ligne affiche aussi Prochain lancement automatique avec son heure, ou Lancements automatiques désactivés. Si le dernier lancement automatique n’a pas pu démarrer, elle en donne la raison.

Voir vos tests

Chaque onglet regroupe les fichiers de test par dossier. Ouvrez un dossier pour voir ses fichiers, puis sélectionnez un fichier : ses tests s’affichent à droite (sur un téléphone, dans un écran dédié), les tests en échec en premier. Un test en échec montre la valeur attendue et la valeur reçue signalées par son lanceur de tests, ainsi que le code actuel autour de la ligne en échec. Filtrez par Échec, Instable ou Jamais exécuté, ou recherchez par nom de fichier ou de dossier.

Un test qui n’a jamais été exécuté affiche Jamais exécuté. L’anneau de réussite n’affiche jamais 100 % tant qu’un test est en échec. Un état est toujours signalé par une icône et un mot, pas seulement par une couleur.

Tests classe les fichiers automatiquement : tests unitaires, tests d’intégration et de bout en bout (dossiers comme e2e, integration, routes ou api, fichiers Playwright et scénarios web) et vérifications. Les vérifications regroupent le lint, les types, la compilation et les scripts de vérification de votre projet, y compris ceux dont le nom porte un suffixe, comme contrast:ui-check ou tabs:guard. Si un dossier est rangé dans la mauvaise famille, ouvrez son menu ⋯ et choisissez Déplacer vers les tests unitaires ou Déplacer vers Intégration et E2E.

Lancer des tests

Choisissez Lancer les tests unitaires, Lancer les tests de non-régression, le bouton de lancement d’un dossier ou d’un fichier, ou Lancer le fichier dans ses détails. Vous n’avez rien à configurer au préalable : Tests construit la commande à partir du script qui exécute déjà ces fichiers dans votre projet (en conservant ses options) ou de la commande par défaut du lanceur de tests, l’enregistre et la lance. Le rapport d’exécution s’ouvre avec sa progression et Arrêter. Fermer l’application n’arrête pas une exécution ; l’instance conserve le résultat.

Pendant qu’un ensemble de tests tourne, le verdict en haut de Tests montre où il en est, avec Voir la progression, qui rouvre l’exécution en cours, et Arrêter, qui arrête tout l’ensemble : les exécutions encore en attente ne démarrent jamais. Vous pouvez quitter Tests et revenir : la progression est toujours là. Lancer les tests unitaires affiche En cours… jusqu’à la fin de l’ensemble, si bien qu’un second clic ne relance jamais les mêmes tests. Quand un outil de test manque sur votre instance, par exemple pytest, seuls ses tests restent non lancés ; les autres s’exécutent quand même.

Une commande enregistrée reste modifiable : ⋯ → Modifier la commande change son exécutable, ses arguments, son niveau, ses prérequis, ses services, ses données de test et son délai maximal.

Choisir combien de fichiers de test tournent à la fois

Fichiers de test simultanés, à côté du verdict, fixe combien de fichiers de test d’un projet s’exécutent en même temps. Automatique, le réglage par défaut, garde le réglage propre à chaque outil de test. Choisissez un nombre, jusqu’au nombre de processeurs de votre instance : chaque exécution du projet, manuelle ou automatique, en lance alors au plus autant. Node, Vitest, Jest et Playwright le suivent, les autres outils de test gardent leur propre réglage, et les exécutions du projet passent alors l’une après l’autre. Une exécution déjà commencée garde son nombre.

Les tests tournent toujours avec une priorité processeur plus basse que l’instance : vos conversations et vos applications restent réactives pendant qu’ils s’exécutent. Ce réglage ne dépend que de vous : l’assistant intégré peut le consulter ou le modifier à votre demande, et une conversation du projet ne le modifie jamais.

Planifier vos tests

Choisissez Lancements automatiques, à côté du verdict, pour lancer les tests d’un projet selon son propre calendrier. Chaque projet en a un :

  • Lancer les tests automatiquement active ou désactive le calendrier.
  • Récurrence : toutes les heures, tous les jours, les jours de semaine, chaque semaine, chaque mois ou une expression cron personnalisée. Deux lancements doivent être espacés d’au moins 15 minutes.
  • Fuseau horaire : le fuseau que suit le calendrier. Votre fuseau d’affichage est proposé en premier ; le changer ensuite ne déplace pas un calendrier enregistré.
  • Que lancer : au moins un choix parmi Tests unitaires, Tests de non-régression, Intégration et E2E et Vérifications.
  • M’avertir : Seulement quand quelque chose échoue (par défaut) ne signale pas les exécutions réussies, mais une exécution en échec, interrompue ou à examiner vous avertit toujours ; Après chaque lancement vous avertit à chaque fois.
  • Exécutions manquées : si l’instance était éteinte à un créneau prévu, Exécuter une fois au retour de l’instance (par défaut) rattrape le retard en une seule exécution, quel que soit le nombre de créneaux manqués ; Ignorer les exécutions manquées attend le créneau suivant.

Un lancement automatique est une exécution ordinaire : il met à jour les cartes et le verdict, et apparaît dans Historique avec son rapport. Il ne chevauche jamais le lancement automatique précédent. En cas de manque de mémoire ou pendant une mise à jour, il patiente et réessaie jusqu’à deux heures ; il ne compte jamais comme un échec. Quand un lancement automatique ne peut pas démarrer, par exemple parce que le précédent était encore en cours, que le projet est à examiner ou qu’il n’y avait rien à lancer, le verdict en indique la raison et le créneau suivant a lieu normalement. Un type de test sans rien à lancer n’empêche pas les autres de partir. Après une mise à jour ou une restauration, les lancements automatiques reprennent d’eux-mêmes ; un créneau manqué entre-temps suit votre choix dans Exécutions manquées.

Ce calendrier ne dépend que de vous : l’assistant intégré peut le consulter ou le modifier à votre demande, et une conversation du projet peut le lire, mais ne le crée ni ne le modifie jamais.

Créer un test

Choisissez Nouveau test en haut à droite :

  • Écrire un test avec l’IA : décrivez un comportement ; l’IA propose le test et vous le relisez avant son enregistrement. Rien ne s’exécute tant que vous ne le lancez pas.
  • Protéger un bug corrigé : créez un test de non-régression à partir des tests qui le couvrent.
  • Scénario web : des étapes cliquées et vérifiées dans le navigateur intégré.
  • Ajouter une commande de test : un script existant de votre projet, comme npm test.

Modifier un test

Sélectionnez un fichier, puis Ouvrir dans l’éditeur pour le modifier vous-même, ou Modifier avec l’IA pour ouvrir une nouvelle conversation sur ce fichier et ce test (rien n’est envoyé tant que vous ne l’envoyez pas). Quand un test a échoué, Corriger avec l’IA reproduit l’échec, corrige le code, puis rejoue le même test et vos tests de non-régression. Dans un test de non-régression, Modifier les tests ajoute ou retire les tests qui le protègent.

Lancer les tests de non-régression

Nommez une collection, décrivez le comportement ou bug protégé, puis sélectionnez les révisions exactes de suites, cas ou scénarios enregistrés. Des tests unitaires, d’intégration, API et E2E peuvent partager une collection sans dupliquer leurs sources. Le lint, les types et la compilation restent des vérifications distinctes.

Enregistrez, puis lancez explicitement cette révision. Les sélections complètes et partielles sont indiquées séparément. Les éléments communs ne s’exécutent qu’une fois ; les révisions contradictoires et sélections vides sont refusées. Une modification ultérieure de collection ne change pas sa composition capturée dans une exécution.

Les collections restent privées à l’instance, sans export Git. Les fichiers de test du projet et les sources de scénarios explicitement exportées se versionnent normalement.

Les tests corrigés deviennent des tests de non-régression

Dans chaque projet, un bug est protégé dès que sa correction est prouvée, sans que personne ait à tenir de liste. Quand un test qui échouait réussit après une modification du code, Tests en fait un test de non-régression :

  • Un test compte comme corrigé quand il réussit à chaque tentative d’une exécution et que son résultat le plus récent, dans les cinq exécutions précédentes du projet, était un échec sur un code différent. Une réussite après une nouvelle tentative, ou sur un code inchangé, n’est pas une correction.
  • Chaque fichier corrigé devient un test de non-régression, nommé d’après son premier test corrigé, qui lance ce fichier seul avec les options du script de votre projet. Son comportement protégé liste les tests corrigés.
  • Une exécution qui corrige plus de cinq fichiers ne protège rien : autant de corrections d’un coup signifient généralement que l’environnement a été réparé, et non que des bugs ont été corrigés.
  • Un fichier déjà protégé par un test de non-régression reste tel quel.

Rien ne s’exécute à sa création : la prochaine exécution des tests de non-régression, lancée par vous ou automatiquement, l’inclut. Modifiez-le ou supprimez-le comme n’importe quel test de non-régression.

Choisir une référence et comparer

Choisissez une exécution conservée comme référence de la collection, puis comparez-en une autre. La référence sert à comparer ; ce n’est pas un troisième mode de sources à exécuter. Aucun succès ne la remplace automatiquement.

Une référence exige des assertions non vides et entièrement observées, des attentes connues, des données isolées et une provenance complète. Une référence en échec peut identifier des échecs préexistants ; les preuves partielles, importées, ignorées, instables ou incomplètes ne sont pas admissibles.

La comparaison distingue nouvelles régressions, échecs préexistants, corrections, ajouts, suppressions, cas ignorés, non exécutés et instabilité. Elle indique les changements d’attentes et la compatibilité configuration/données/runtime/cible. Une absence dans une sélection partielle n’est pas une suppression. Des preuves de comparaison complètes peuvent inclure des échecs ; « complet » ne signifie pas réussi.

Ajouter un scénario web

Modifiez le comportement, la cible, les données, les préconditions, les étapes, les assertions et le nettoyage d’un scénario. Utilisez des localisateurs stables par rôle, libellé, identifiant de test ou texte. Ce n’est pas un enregistreur de clics.

Par exemple, protégez la persistance d’une application de tâches avec ce parcours :

  1. Ouvrez l’application avec des données de test dédiées.
  2. Saisissez un titre connu dans le champ de nouvelle tâche et choisissez l’ajout.
  3. Vérifiez que la tâche est visible, puis marquez-la comme terminée.
  4. Rechargez la page.
  5. Vérifiez que la même tâche reste visible et cochée.

Enregistrez le scénario avant de le lancer. Enregistrer la source du test est une autre action explicite : choisissez un chemin relatif au projet pour conserver la source générée. L’export refuse des octets existants différents. Modifier un fichier exporté invalide sa correspondance et bloque le rejeu. Relisez la révision du scénario et sa correspondance source ; n’écrasez pas le travail concurrent. Les preuves antérieures restent historiques. La préparation du test ne change pas le démarrage, l’arrêt ou l’activation des applications ordinaires.

Le navigateur intégré utilise des contextes Chromium éphémères et bloque les service workers. Il ne qualifie ni le fonctionnement hors ligne/PWA, ni Safari, Firefox, Android/iOS natifs ou les performances d’appareils réels. La correspondance entre cible et sources peut rester incertaine : les assertions réussies affichent alors Réussi, avec ce fait dans Détails, mais l’exécution n’est ni une validation complète ni une référence complète admissible. Une capture est une preuve ; une non-régression visuelle exige une assertion exécutée et une référence visuelle gérée explicitement.

Examiner les échecs et conserver les preuves

Le rapport d’une exécution s’ouvre sur sa réponse : Réussi, Échec, Instable, ou une phrase qui explique pourquoi il n’y en a pas, avec le nom de ce qui a été lancé, son nombre de tests, sa durée et sa date. Les tests en échec viennent en premier, avec les valeurs attendue et reçue quand le moteur les fournit ; Afficher le journal ouvre le journal, et Détails regroupe les remarques (fichiers modifiés pendant l’exécution, tests qui ont utilisé les données du projet), les fichiers enregistrés, le déroulement et la comparaison avec une autre exécution. Journaux et listes sont bornés et paginés ; une troncature reste visible.

Succès de commande, verdict, complétude du rapport et provenance sont distincts. Une sortie à zéro sans rapport exploitable prouve seulement le succès de la commande. Zéro cas, rapport/authentification/dépendance absent, cas ignoré ou interruption ne valident rien. Une tentative échouée puis réussie reste Instable ; les deux sont gardées.

Les captures, traces et rapports retenus par Tests survivent à leur session navigateur. Le téléchargement exige l’authentification de l’instance ; le HTML/SVG actif est fourni en pièce jointe, jamais exécuté comme rapport. Toute preuve absente ou endommagée est signalée. Ouvrir une source retrouve le fichier actuel du projet, sans garantir ses octets historiques. Les modifications ultérieures ne réécrivent pas les anciens résultats.

Arrêter attend les processus enfants possédés et préserve les autres applications et conversations. Un nettoyage refusé reste visible. Fermer l’écran, perdre le réseau ou passer le client en arrière-plan n’arrête pas l’exécution. Retrouvez son rapport exact après reconnexion. Le redémarrage de l’instance interrompt une continuité non prouvée sans rejouer automatiquement de commande. Les exécutions et notifications renvoient au résultat Tests conservé.

Transformer un bug en comportement protégé

Gardez la chaîne : reproduire → conserver un test rouge → corriger le code → même attente verte → rejouer la collection de non-régression. Les rejeux créent des enregistrements liés. Modifier, supprimer ou affaiblir une assertion ne résout pas automatiquement un défaut.

Écrivez vos tests ou choisissez Décrire un comportement pour obtenir une proposition modifiable de test unitaire ou de scénario. Utilisez les sélecteurs existants de Harnais, Modèle, Effort et compte. Relisez assertions concrètes, fichiers, données et préconditions ; complétez les questions avant de marquer explicitement la révision prête et de l’enregistrer. Génération, enregistrement et lancement restent distincts. Enregistrer une proposition unitaire révisée écrit son fichier de test dans le projet ; enregistrer un scénario stocke sa définition, avec un export facultatif des sources comme action distincte. Une proposition n’a aucun verdict exécuté. Des sources modifiées peuvent exiger une nouvelle revue avant l’enregistrement.

Corriger avec l’IA relie l’échec exact à une reproduction, une conversation de correction visible et une nouvelle vérification. Reproduction absente, attentes modifiées et preuves de non-régression incomplètes restent explicites. L’explication d’un modèle ne remplace jamais les assertions. Les tests locaux n’exigent aucun modèle ; l’IA facultative utilise l’usage, les tarifs et quotas existants du fournisseur. Un coût absent reste inconnu, pas nul. Voir Comptabilisation de l’utilisation. Rien ne lance Ship ni ne publie.

Moteurs qualifiés et prérequis

Ces versions exactes ont été qualifiées depuis les sources sous Linux avec Node 22.22.2/22.23.2. Les dépendances doivent exister ; Tests ne les installe ni ne les met à jour. Aucune plage de versions compatible n’est sous-entendue.

Moteur Cas et rejeu ciblé Couverture et limites
Node test runner 22.22.2 / 22.23.2 Cas structurés, hooks, cas ignorés/à faire ; exécutable Node courant direct. Aucun rejeu exact par cas ni historique de retries. Couverture native explicite des lignes/branches/fonctions avec son périmètre mesuré ; limite de 128 fichiers/64 KiB de métadonnées de couverture.
Vitest 4.1.10 Point d’entrée direct ; sélection exacte de cas conservés après collecte supervisée ; toutes les tentatives sont conservées. Couverture et inversion d’échec attendu non qualifiées. Les wrappers de cycle de vie et configurations ne conservant pas le plugin de preuve sont refusés.
Jest 30.2.0 Nom complet unique dans un fichier épinglé ; un cas sélectionné par commande, plusieurs commandes bornées pour plusieurs cas. Aucun import de couverture. Noms ambigus, presets, configurations multiprojets/TypeScript et runners personnalisés refusés.
pytest 8.4.2 / CPython 3.10.12 Python direct d’un environnement virtuel avec -m pytest ; identités exactes et préparation/exécution/nettoyage. Couverture, wrappers, distribution et plugins de retry non qualifiés. Une dépendance pytest absente n’est pas réparée implicitement.
Playwright Test 1.63.0 Runner installé du projet ; identités de projets/répétitions, tentatives et pièces jointes. Aucun rejeu exact par cas. Couverture et inversion d’échec attendu non qualifiées. Sa politique navigateur est distincte de celle du navigateur intégré.
Commande personnalisée / JUnit Résultat de commande opaque ou cas réellement fournis par un rapport borné. Aucun rejeu exact par cas. Aucune couverture, aucun compteur ni retry deviné ; les dialectes XML non supportés restent invalides/incomplets.

Une commande JUnit personnalisée doit écrire son rapport courant dans le répertoire privé de l’exécution, avec TEST_REPORT_PATH / TEST_REPORT_DIR ou les arguments explicites {{TEST_REPORT_PATH}} / {{TEST_REPORT_DIR}}. Un ancien rapport du projet ne valide pas une nouvelle exécution. L’import XML externe est disponible via l’API/action tests.importJUnit, sans bouton d’import dans l’interface actuelle. Ses compteurs n’établissent ni exécution locale, ni provenance actuelle, ni référence.

L’exécution sous Linux est qualifiée. Un mécanisme de possession existe pour Windows, mais l’exécution native Windows reste non qualifiée. L’exécution sur une instance macOS n’est actuellement pas supportée ; un client macOS peut piloter une instance distante supportée. L’interface Android/iOS ne certifie pas les tests d’applications natives. Sources, payload exact, installation candidate privée, client servi, version publique et appareils réels sont des preuves distinctes ; aucune n’établit les autres.

Outils de conversation

Les conversations ordinaires autorisées du projet exposent cinq outils MCP et leurs commandes CLI : aircode_tests_catalog / catalog, aircode_tests_describe / describe, aircode_tests_run / run, aircode_tests_status / status et aircode_tests_open / open. Lisez le schéma avant toute mutation :

aircode-tests catalog
aircode-tests describe --input '{"action":"tests.launchUnits"}'
aircode-tests run --input '{"action":"tests.units","input":{}}'

Utilisez tests.launchUnits pour les suites unitaires ou tests.launchRegression pour une collection exacte, avec les références de périmètre/révision retournées et la clé explicite du schéma. La capacité de session fournit le projet ; n’ajoutez pas de champ project. --input - accepte du JSON borné sur l’entrée standard. status reçoit {scopeId,ownerKind,ownerId} ; open reçoit la même identité ou {} pour Tests. Conservez le openPath retourné. Avec MCP, utilisez les mêmes arguments dans l’outil aircode_tests_* correspondant. Voir Documentation pour l’AI.

Les lancements depuis une conversation acceptent uniquement les recettes et services reconnus par la découverte. Utilisez un script reconnu du projet ou lancez une commande personnalisée depuis l’interface du propriétaire.

Après une réponse perdue, consultez l’état et réutilisez la même clé et les mêmes entrées pour une nouvelle tentative identique explicite. Lire l’état ne relance rien. Les sessions Planning ou en lecture seule ne peuvent pas écrire ; des outils expirés ou révoqués exigent une reprise normale de conversation. Ils n’accordent ni shell général ni transfert public de preuves. Ne modifiez pas le stockage et ne fabriquez pas d’identifiants d’accès pour contourner un refus.

Stockage et refus actionnables

Définitions, références et faits d’exécution immuables résident dans le domaine SQLite privé de Tests. Les gros journaux, captures et traces sont des fichiers compagnons privés. Une sauvegarde de base ne contient pas ces octets : conservez les compagnons dans une sauvegarde cohérente de l’instance. Ne copiez jamais une base WAL vivante pour la sauvegarder. Les preuves uniques/essentielles sont conservées par défaut ; seule une pièce jointe redondante vérifiée d’une exécution terminée peut être retirée explicitement. Aucune purge générale de preuves uniques n’est proposée. Les secrets reconnus sont réduits ou refusés ; les filtres ne reconnaissent pas tous les secrets des journaux, images, archives ou données.

Refus ou état à examiner Action suivante
Aucune suite unitaire / collection vide Classez et enregistrez les suites, ou ajoutez des membres exacts à la collection.
Moteur absent ou non supporté Vérifiez l’exécutable, la dépendance installée et la version qualifiée ; utilisez au besoin une commande personnalisée aux limites explicites.
Données non isolées / sources incertaines Le rapport affiche Réussi, avec ce fait dans Détails ; préparez des fixtures dédiées avant qu’une telle exécution puisse devenir une référence.
Rejeu ciblé indisponible Relancez la sélection complète ou examinez son rapport conservé.
Sources modifiées / référence incomplète Relisez sources actuelles, attentes et compatibilité, puis choisissez explicitement une nouvelle sélection ou référence appropriée.
Exécution différée pour file, mémoire, disque ou quota Résolvez la contrainte indiquée puis demandez explicitement un lancement ou une reprise. Aucun délai de réinitialisation ni retry n’est inventé.
Nettoyage refusé / preuve absente Examinez le motif et les preuves conservés ; utilisez la récupération de preuves disponible sans rejouer les tests ni supprimer manuellement l’état privé.