Debug in JavaScript

Debugger JavaScript di Acrobat Professional

Il debugger JavaScript di Acrobat Professional consente di verificare gli script JavaScripts. Il debugger include la console JavaScript utile per verificare parti del codice JavaScript nella scheda Anteprima PDF. La console JavaScript offre un'interfaccia interattiva utile alla verifica di parti del codice JavaScript e alla sperimentazione di proprietà oggetto e metodi. Grazie alla natura interattiva, la console JavaScript funziona come un editor che supporta l'esecuzione di singole righe o blocchi di codice.

Per abilitare il debugger JavaScript per Designer ed eseguire il codice dalla console JavaScript, è necessario abilitare JavaScript e il relativo debugger in Acrobat Professional.

Attivazione del debugger JavaScript per Designer

1. Avviare Designer.

2. Avviare Acrobat Professional.

3. In Acrobat Professional, selezionare Modifica > Preferenze.

4. Selezionare JavaScript dall'elenco a sinistra.

5. Nel caso in cui non sia stato selezionato, selezionare Abilita JavaScript di Acrobat.

6. Nel debugger JavaScript, selezionare Abilita Debugger JavaScript dopo il riavvio di Acrobat.

7. Selezionare Abilita console interattiva. Quest'opzione consente di valutare il codice che viene scritto nella console JavaScript.

8. Selezionare Mostra console in caso di errori e messaggi. Tale opzione assicura che ogni volta che si verificano degli errori la console JavaScript visualizzi informazioni utili.

9. Fare clic su OK per chiudere la finestra di dialogo Preferenze.

10. Chiudere Acrobat Professional.

11. In Designer, fare clic sulla scheda Anteprima PDF.

12. Premere Ctrl+J per aprire il Debugger JavaScript.

Per impedire che il debugger JavaScript scompaia in Designer

Se il debugger JavaScript di Acrobat è attivo e scompare quando si fa clic su componenti dell'interfaccia Designer, è necessario interrompere il processo Acrobat.exe in Task Manager di Microsoft Windows. Il processo Acrobat.exe rimane in esecuzione una volta chiuso Acrobat per consentire una rapida visualizzazione di Acrobat, se riavviato. L'arresto del processo determina l'annullamento dell'associazione fra il debugger JavaScript e la sessione di Acrobat, in modo da consentire l'impiego del debugger JavaScript in Designer.

1. In Task Manager di Windows, fare clic sulla scheda Processi.

2. Nella colonna Nome immagine, fare clic con il pulsante destro del mouse su Acrobat.exe e selezionare Termina processo.

Valutazione del codice mediante la console JavaScript

Sono disponibili tre metodi per valutare righe singole e multiple di codice usando la console JavaScript di Acrobat.

Valutazione della porzione di una riga di codice

 Evidenziare la parte desiderata nella finestra della console, quindi premere Invio sul tastierino numerico o Ctrl+Invio sulla tastiera.

Valutazione di una riga singola del codice

 Posizionare il cursore sulla riga appropriata della finestra della console, quindi premere Invio sul tastierino numerico o Ctrl+Invio sulla tastiera.

Valutazione di più righe di un codice

 Evidenziare le righe desiderate nella finestra della console, quindi premere Invio sul tastierino numerico o Ctrl+Invio sulla tastiera.

Eliminazione del contenuto visualizzato nella console JavaScript

 All'interno della finestra della console fare clic su Cancella.

Nella finestra della console è visualizzato il risultato dell'ultimo script JavaScript valutato.

Dopo aver valutato ciascun script JavaScript, nella console verrà visualizzato undefined, che rappresenta il valore restituito dall'istruzione. Si noti che il risultato di un'istruzione non equivale al valore di un'espressione all'interno dell'istruzione. Il valore restituito undefined non significa che il valore di script non è definito ma che il valore restituito dell'istruzione JavaScript non è definito.

Feedback di debug utilizzando la console JavaScript

Se si creano script in JavaScript, è possibile inviare messaggi alla console JavaScript da Acrobat in fase di esecuzione utilizzando il metodo console.println incluso nel modello di oggetto JavaScript da Acrobat. Quando eseguito, il metodo console.printIn visualizza un valore di stringa nella console JavaScript. Il valore di stringa può essere un messaggio di testo creato per il debug o il valore di stringa di campi o espressioni.

Ad esempio, si consideri uno scenario con una struttura del modulo semplice contenente un singolo campo numerico (NumericField1) e un pulsante (Button1). In questo caso, il seguente script JavaScript genera un messaggio che mostra del testo e il valore attualmente visualizzato nel campo numerico. Aggiungendo il calcolo o lo script all'evento click dell'oggetto pulsante, è possibile visualizzare in modo interattivo il valore del campo numerico in una nuova finestra di dialogo facendo clic sul pulsante.

    console.println("Il valore è: " + NumericField1.rawValue);

Per ulteriori informazioni sul metodo console.println e sul modello di oggetto JavaScript in Acrobat, consultare il documento Developing Acrobat Applications Using JavaScript (solo in lingua inglese).

Per ulteriori informazioni sulla console e sul debugger JavaScript, consultare il documento Developing Acrobat Applications Using JavaScript (solo in lingua inglese).

Feedback di debug con il metodo alert

Se si desidera la restituzione di una finestra di messaggio durante un evento calculate, è possibile sfruttare il metodo alert dal modello di oggetto JavaScript di Acrobat. Ad esempio, il seguente script restituisce il valore di un campo di testo:

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

Per ulteriori informazioni sul metodo alert e sul modello di oggetto JavaScript in Acrobat, consultare il documento Developing Acrobat Applications Using JavaScript (solo in lingua inglese).