Débogage JavaScript

JavaScript Debugger dans Acrobat Professional

Le JavaScript Debugger dans Acrobat Professional permet de tester les scripts JavaScript. Cet outil inclut la console JavaScript qui permet de tester des parties du code JavaScript dans l’onglet Aperçu PDF. Cette console fournit une interface interactive et pratique pour contrôler des parties de code JavaScript et travailler sur les propriétés et méthodes d’objets. La console JavaScript Console est interactive : elle se comporte donc comme un éditeur permettant l’exécution de lignes uniques ou de blocs de code.

Pour activer JavaScript Debugger pour Designer et exécuter du code depuis la console JavaScript, vous devez activer JavaScript et JavaScript Debugger dans Acrobat Professional.

Pour activer JavaScript Debugger pour Designer

1. Démarrez Designer.

2. Démarrer Acrobat Professional.

3. Dans Acrobat Professional, sélectionnez Edition > Préférences.

4. Sélectionnez JavaScript dans la liste située à gauche.

5. Sélectionnez l’option d’activation d’Acrobat JavaScript si besoin est.

6. Dans JavaScript Debugger, sélectionnez l’option indiquant qu’il faut activer JavaScript Debugger après le redémarrage d’Acrobat.

7. Sélectionnez l’option d’activation de la console interactive. Cette option vous permet d’évaluer le code que vous écrivez dans la console JavaScript Console.

8. Sélectionnez l’option d’affichage de la console lors d’erreurs et de messages. Cette option vous assure que la console affichera des informations utiles dès que vous ferez des erreurs.

9. Cliquez sur OK pour fermer la boîte de dialogue Préférences.

10. Quitter Acrobat Professional.

11. Dans Designer, cliquez sur l’onglet Aperçu PDF.

12. Appuyez sur Ctrl+J pour ouvrir JavaScript Debugger.

Pour maintenir ouvert JavaScript Debugger dans Designer

Si l’outil JavaScript Debugger est actif dans Acrobat et qu’il disparaît dès que vous cliquez sur des composants dans l’interface de Designer, vous devez arrêter le processus Acrobat.exe dans le Gestionnaire des tâches de Microsoft Windows. Le processus Acrobat.exe continue de s’exécuter après la fermeture d’Acrobat de manière à ce qu’Acrobat puisse s’ouvrir plus vite en cas de redémarrage. L’interruption du processus met fin à l’association entre JavaScript Debugger et la session d’Acrobat Professional, ce qui permet d’utiliser JavaScript Debugger dans Designer.

1. Dans le Gestionnaire des tâches de Windows, cliquez sur l’onglet Processus.

2. Dans la colonne Nom de l’image, cliquez avec le bouton droit de la souris sur Acrobat.exe et choisissez Terminer le processus.

Evaluation du code à l’aide de la console JavaScript

Il existe trois manières d’évaluer une seule ou plusieurs lignes de code à l’aide de la console JavaScript à partir d’Acrobat.

Pour évaluer une partie d’une ligne de code

 Mettez en surbrillance la partie dans la fenêtre de la console et appuyez sur la touche Entrée du pavé numérique ou sur les touches Ctrl+Entrée du clavier normal.

Pour évaluer une seule ligne de code

 Placez le curseur sur la ligne souhaitée dans la fenêtre de la console et appuyez sur la touche Entrée du pavé numérique ou sur les touches Ctrl+Entrée du clavier normal.

Pour évaluer plusieurs lignes de code

 Mettez en surbrillance la partie dans la fenêtre de la console et appuyez sur la touche Entrée du pavé numérique ou sur les touches Ctrl+Entrée du clavier normal.

Pour supprimer le contenu affiché dans la console JavaScript

 Cliquez sur Effacer dans la fenêtre de la console.

Le résultat de la dernière instruction JavaScript évaluée s’affiche dans la fenêtre de la console.

Après l’évaluation de chaque script JavaScript, la fenêtre de console imprime undefined, c’est-à-dire la valeur renvoyée de l’instruction. Notez que le résultat d’une instruction est différent de la valeur d’une expression dans l’instruction. La valeur renvoyée undefined ne signifie pas que la valeur du script est indéterminée : elle indique que la valeur retournée de l’instruction JavaScript est indéterminée.

Affichage d’informations de débogage dans la console JavaScript

Si vous créez des scripts à l’aide de JavaScript, vous pouvez envoyer les messages de sortie vers la console JavaScript à partir d’au moment de l’exécution. Pour ce faire, utilisez la méthode console.println répertoriée dans le modèle d’objet JavaScript d’Acrobat. Lorsqu’elle est exécutée, la méthode console.println affiche une valeur de chaîne dans la console JavaScript. Il peut s’agit, en l’occurrence, d’un message de texte que vous rédigez à des fins de débogage ou de la valeur de chaîne de champs ou d’expressions.

Prenons par exemple une simple conception de formulaire contenant un seul champ numérique (NumericField1) et un bouton (Button1). Dans ce cas, le script JavaScript suivant génère un message présentant du texte et la valeur actuellement affichée dans le champ numérique. En ajoutant le calcul ou le script à l’événement click de l’objet de bouton, il est possible de présenter de façon interactive la valeur du champ numérique dans une nouvelle boîte de dialogue en cliquant sur le bouton.

    console.println("The value is: " + NumericField1.rawValue);

Pour plus d’informations sur la méthode console.println et le modèle d’objet JavaScript à partir Acrobat, voir Developing Acrobat Applications Using JavaScript (En anglais uniquement).

Pour plus d’informations sur la console JavaScript et JavaScript Debugger, voir Developing Acrobat Applications Using JavaScript(En anglais uniquement).

Affichage d’informations de débogage à l’aide de la méthode alert

Si vous souhaitez renvoyer une zone de message lors d’un événement calculate, vous pouvez utiliser la méthode alert du modèle d’objet JavaScript à partir d’Acrobat. Le script suivant renvoie, par exemple, la valeur d’un champ de texte :

    var oField = xfa.resolveNode("TextField1").rawValue; app.alert(oField);

Pour plus d’informations sur la méthode alert et le modèle d’objet JavaScript à partir d’Acrobat, voir Developing Acrobat Applications Using JavaScript (En anglais uniquement).