Summary - Adobe 12001196 - Acrobat - Mac Manual

Acrobat JavaScript Debugger
3

Summary

The events DocWillPrint and DocDidPrint cannot be debugged because the printing
progress bar conflicts with the debugger. Press the Escape key to clear this situation. Debug
scripts using different event triggers and then change the trigger to the required event.
Debugging scripts in Acrobat from inside a browser (IE, NS) has some limitations. They're
mostly due to the fact that not all scripts contained in a PDF file may be available if the PDF
file has not been completely downloaded.
Debugging is not possible with a model dialog open. This occurs, for example, when
debugging a batch sequence. A script may create and define a dialog and become not
debuggable due to the modal characteristic of these dialogs. Debugging these scripts may
hang the Acrobat application, in which case the correct exit is to hit the Esc key.
Debugging script with a running event initiated by either app.setInterval or
app.setTimeOut methods may cause a recurring alert boxes to appear. Use the Esc key
after the model dialog is dismissed to resolve the problem.
Hitting the Esc key is the last resort in case debugging of scripts causes the Acrobat
application to hang.
Summary
The Acrobat JavaScript Debugger is a is a fully capable tool for troubleshooting problems in
Acrobat JavaScript scripts. In combination with the Edit > Preferences dialog, the
debugger enables you to make very specific choices about how to control the behavior of
your Acrobat JavaScript development environment. It consists of three main sets of
controls for selecting and executing scripts. Six button controls allow starting and quitting
the debugger, as well as single stepping through code, skipping over functions, and exiting
functions at any point. A Scripts window enables you select the script you want to debug.
Call Stack and Inspect lists, in combination with an Inspect details window, enable you to
view nested functions and to inspect the details of variables, watches, and breakpoints. You
can use the details window controls to set and clear breakpoints, inspect variable values
while stepping through JavaScript code, and to create and delete custom watches to filter
what you want to examine during script execution. You can also trace the stack and view
the exact locations of stack frames in a script.
53
Acrobat JavaScript Scripting Guide