Déboguer l’extrait de code

Vous pouvez déboguer des extraits à partir de la fenêtre de l’éditeur Snippet . Le débogueur vous permet de voir les variables dans le code de l’extrait. Cela peut vous aider à résoudre des problèmes dans votre code. Il existe cinq options pour déboguer les extraits de code :

• Vérifier la syntaxe dans l’extrait de code. Vous pouvez le faire à tout moment pendant le codage d’un extrait de code. Cette option n’utilise pas l’outil de débogage.
• Déboguer l’ensemble de l’extrait de code pour voir les variables et leurs valeurs après l’exécution de l’ensemble de l’extrait de code.
• Définir un point d’arrêt pour arrêter le débogage à une certaine ligne du code.
• Parcourir chaque ligne de l’extrait de code et observer comment les variables et leurs valeurs changent ligne par ligne.
• Utiliser les instructions TRACE pour produire des données dans le volet Trace de la fenêtre de l’éditeur Snippet .

En outre, si votre code contient des objets dynamiques ou des tableaux, vous pouvez afficher leur contenu et voir comment il change.

Vérifier la syntaxe de l’extrait de code

Vous pouvez demander à Studio de vérifier la syntaxe d’un extrait de code.

1. Dans Studio, ouvrez un script contenant une action Snippet.
2. Double-cliquez sur l’action Snippet.
3. Ajoutez le code Snippet dans l’onglet Text View , s’il n’en contient pas déjà.

4. Cliquez sur l’icône Check Syntax en bas de la fenêtre de l’éditeur Snippet .

   Si aucune erreur de syntaxe n’est trouvée, le champ d’état situé à côté de l’icône Vérifier la syntaxe affiche le message Okay.

   Si des erreurs de syntaxe sont détectées, un message d’erreur s’affiche, décrivant l’erreur. La description comprend le numéro de ligne où se trouve l’erreur. En outre, le champ d’état situé à côté de l’icône de vérification de la syntaxe affiche le message suivant : Error at line [#].

5. Corrigez les problèmes de syntaxe détectés.
6. Vous pouvez sélectionner une ou plusieurs lignes dans le code de l’extrait et cliquer sur l’icône Comment out selected lines . Cette fonction est utile si vous souhaitez ignorer une erreur et vérifier les autres erreurs.
7. Vous pouvez sélectionner une ou plusieurs lignes commentées dans le code de l’extrait et cliquer sur l’icône Uncomment the selected lines .

Utiliser l’outil de débogage

1. Dans Studio, ouvrez un script contenant une action Snippet.
2. Double-cliquez sur l’action Snippet.
3. Ajoutez le code Snippet dans l’onglet Text View , s’il ne contient pas déjà.
4. Dans la partie droite de la fenêtre Snippet editor, cliquez sur l’onglet Debugger.
5. Cliquez sur la flèche descendante à droite de l’icône Debug et sélectionnez Start.

6. Si le code contient des erreurs de syntaxe, la fenêtre Snippet editor s’agrandit. Toutes les erreurs dans le code apparaissent dans un volet au bas de la fenêtre. S’il n’y a pas d’erreur, passez à l’étape suivante.

   Afficher l’image

   
   1. Corrigez les erreurs.
   2. Lorsque les erreurs ont été corrigées, cliquez sur les icônes Close ou Clear Trace Output pour fermer le volet d’erreurs.
   3. Redémarrez le débogueur.
7. Consultez le contenu de l’onglet Variables as Text . L’onglet montre les variables et leurs valeurs lorsque tout le code a été exécuté si vous n’avez pas placé de point d’arrêt.
8. Vous pouvez sélectionner une ou plusieurs lignes dans le code de l’extrait et cliquer sur l’icône Comment out selected lines . C’est utile si vous voulez supprimer du code pour voir comment le résultat du débogage change.
9. Vous pouvez sélectionner une ou plusieurs lignes de code commentées et cliquer sur l’icône Uncomment the selected lines pour ajouter ces lignes dans l’extrait de code.

Déboguer avec un point d’arrêt

Vous pouvez définir un point d’arrêt si vous souhaitez que le débogage s’arrête à une ligne spécifique du code de l’extrait. Cela vous permet de voir les variables et les valeurs à mi-chemin de l’extrait sans avoir à le parcourir ligne par ligne.

1. Dans Studio, ouvrez un script contenant une action Snippet.
2. Double-cliquez sur l’action Snippet.
3. Ajoutez le code Snippet dans l’onglet Text View , s’il ne contient pas déjà.

4. Cliquez dans la colonne à gauche des numéros de ligne dans la fenêtre Snippet editor. Un cercle rouge apparaît à ce numéro de ligne.

   Afficher l’image

   
5. Dans la partie droite de la fenêtre Snippet editor, cliquez sur l’onglet Debugger.
6. Cliquez sur la flèche descendante à droite de l’icône Debug et sélectionnez Start.

7. Si le code contient des erreurs de syntaxe, la fenêtre Snippet editor s’agrandit. Toutes les erreurs dans le code apparaissent dans un volet au bas de la fenêtre. S’il n’y a pas d’erreur, passez à l’étape suivante.

   Afficher l’image

   
   1. Corrigez les erreurs.
   2. Lorsque les erreurs ont été corrigées, cliquez sur les icônes Close ou Clear Trace Output pour fermer le volet d’erreurs.
   3. Redémarrez le débogueur.
8. Consultez le contenu de l’onglet Variables as Text . L’onglet montre les variables et leurs valeurs au point d’arrêt, si vous en avez défini un. La ligne où le débogage s’est arrêté pour le point d’arrêt est mise en évidence dans la fenêtre Snippet Editor.
9. Si vous avez terminé avec le point d’arrêt, cliquez à nouveau sur le cercle rouge pour l’effacer.
10. Placez un autre point d’arrêt, si vous en avez besoin.
11. Pour poursuivre le débogage à partir du point d’arrêt, cliquez sur l’icône Resume .
12. Pour arrêter le débogage, cliquez sur l’icône Stop Debugging .

Entrer par le code de l’extrait

Vous pouvez utiliser l’outil de débogage pour parcourir le code de l’extrait ligne par ligne. Cela vous permet de voir comment les variables et leurs valeurs changent au fur et à mesure de l’exécution de chaque ligne.

1. Dans Studio, ouvrez un script contenant une action Snippet.
2. Double-cliquez sur l’action Snippet.
3. Ajoutez le code Snippet dans l’onglet Text View , s’il ne contient pas déjà.
4. Dans la partie droite de la fenêtre Snippet editor, cliquez sur l’onglet Debugger.
5. Cliquez sur la flèche descendante à droite de l’icône Debug et sélectionnez Start.

6. Si le code contient des erreurs de syntaxe, la fenêtre Snippet editor s’agrandit. Toutes les erreurs dans le code apparaissent dans un volet au bas de la fenêtre. S’il n’y a pas d’erreur, passez à l’étape suivante.

   Afficher l’image

   
   1. Corrigez les erreurs.
   2. Lorsque les erreurs ont été corrigées, cliquez sur les icônes Close ou Clear Trace Output pour fermer le volet d’erreurs.
   3. Redémarrez le débogueur.
7. Consultez le contenu de l’onglet Variables as Text . Elle affiche les variables du code et leurs valeurs au début de l’extrait de code.
8. Cliquez sur l’icône Step pour passer à la ligne suivante dans l’extrait.
9. Répétez les deux étapes précédentes pour chaque ligne de l’extrait.
10. Si vous voulez sauter les lignes de code restantes, cliquez sur l’icône Resume . L’onglet Variables as Text affiche les variables et leurs valeurs lorsque tout le code de l’extrait a été exécuté.
11. Pour arrêter le débogage, cliquez sur l’icône Stop Debugging , puis répétez ce processus à partir de l’étape 3.

Afficher le contenu des objets dynamiques et des tableaux

Vous pouvez afficher le contenu des objets dynamiques dans la fenêtre de l’éditeur Snippet lorsque vous exécutez le débogueur. Cela vous permet de vérifier que l’objet contient les données qu’il est censé contenir à chaque étape de votre code.

1. Dans Studio, double-cliquez sur une action Snippet.
2. Ajouter un extrait de code, si nécessaire.
3. Dans l’onglet Debugger , cliquez sur l’onglet Variables sous forme d’arborescence.
4. Dans l’onglet Debugger , cliquez sur la flèche vers le bas à côté de l’icône Commencer le débogage et sélectionnez Entrer dans . Si vous ne souhaitez pas parcourir le code ligne par ligne, cliquez sur l’icône Commencer le débogage.
5. Cliquez sur l’icône Étape et observez le contenu de l’onglet Variables as Tree. Chaque fois que vous cliquez sur Étape, ce champ est mis à jour avec les variables et les objets du script après la ligne de code précédente. Passez cette étape si vous avez cliqué sur Commencer le débogage.
6. Lorsque vous avez parcouru toutes les lignes de code ou si vous avez cliqué sur Commencer le débogage, l’onglet Variables as Tree affiche toutes les variables, tous les objets et leur contenu à la fin de l’extrait.

7. Vous pouvez cliquer sur l’icône + à côté des tableaux de chaînes ou des objets dynamiques dans le code pour les développer. Si le contenu est un autre tableau ou objet, vous pouvez continuer à développer l'arborescence pour voir ce que contient chaque entité.

   Afficher l’image

   

Déboguer à l’aide de TRACE

Le mot-clé TRACE  vous permet de déboguer en utilisant la journalisation. Ce mot-clé ne fonctionne que lors de l’utilisation de l’outil de débogage dans la fenêtre de l’éditeur Snippet . Lorsque vous l’incluez dans votre code d’extrait et que vous lancez le débogueur, le texte est affiché dans le volet Trace qui apparaît au bas de la fenêtre de l’éditeur Snippet .

Le mot-clé TRACE est ignoré en dehors de la fenêtre de l’éditeur Snippet . Il ne fonctionne qu’avec l’outil de débogage.

La syntaxe est la suivante : TRACE "<text>"

Le texte entre guillemets est affiché dans la fenêtre de l’éditeur Snippet . Il apparaît dans le volet Trace au bas de la fenêtre.

Vous pouvez utiliser la substitution de variables entre les guillemets pour imprimer la valeur des variables. Par exemple :

FOR i=1 TO 5
{
   TRACE "I = {i}"
}

Le résultat de cet exemple est le suivant :

I = 1

I = 2

I = 3

I = 4

I = 5