The Run Window
The Run window displays information about the currently running script. In the Run window you can manually control script execution, view script output as it is generated, see and modify variables, and follow the progress of the script with animation or tracing.
The Eggplant Functional Run window
- The Run Window Toolbar
- The Script Frame Pop-Up Menu
- The Script Display Pane
- Dynamic Breakpoints
- The Log Pane
- The Ad Hoc Do Box and Do Button
- The Variable Watcher Pane
- Add/Remove List and Property List Items Buttons
1. The Run Window Toolbar
The Run window toolbar contains buttons and menus for the tasks you can perform while your script is running. When you change the width of your Run window, the buttons and menus available on the toolbar change. If you see the >> button, it indicates there are more options. When you click >>, a menu displays showing the buttons and menus that do not fit in the Run window at its current size.
Run Script/Abort Script
The Run Script button reruns the last script that was run, or the entire script from which a selection was run. While a script is running, the Run Script button becomes Abort Script.
While a script is running (and not paused), you cannot perform any manual actions in the Viewer window, or open and close VNC connections.
You can run the script in debug mode by Alt-clicking (Option-clicking on Mac) the Run Script button. This loads the script for execution and immediately pauses it, allowing you to step through line by line. This is the same as choosing Run > Debug Script.
Run Selection
The Run Selection button executes only the selected part of a script. The selection does not have to include an entire line of code, but it must be syntactically complete and executable. (For example, if you select the beginning of an if
block, you must select all the way through the end``if
statement.)
You can run the selection in debug mode by Alt-clicking (Option-clicking on Mac) the Run Selection
button. This loads the selection for execution, but immediately pauses it, allowing you to step through it line-by-line to closely follow its execution.
When you run a selection, results are not generated in the Results pane of the Suite Editor.
Pause / Continue
The Pause/Continue buttons allow you to pause and continue execution whenever a script is running.
When the script execution is paused, you can perform additional operations:
- Type commands in the Ad Hoc Do Box. (See The Ad Hoc Do Box and Do Button section below.)
- Use the debug mode tools: Step Into, Step Over, and Step Out. (See below.)
- Interact with the Viewer window in Live Mode.
Step Into
The Step Into button executes the next line of a script, then pauses. If this line calls another script or handler, the script "steps into" the first line of the called script or handler before pausing again.
The Step Over button performs a similar function, with one exception: If the line calls another script or handler, Step Over executes the called script or handler entirely before pausing.
Step Over
Like Step Into, Step Over executes the next line of the script, then pauses. However, if this line calls another script or handler, that script or handler runs in its entirety, "stepping over" it to the next line of original script before pausing again.
During the execution of the script or handler that is stepped over, you can click Pause to regain control of the execution before the Step Over command has finished.
Step Out
Step Out executes all the remaining lines in the current script or handler, then pauses. (Using Step Out on your initial handler is the same as clicking Continue.)
During the execution of the code being stepped out of, you can click Pause to regain control before the Step Out command has finished.