Debugging Scripts
T-HSCP-001-003
If you are having issues with a script you're working on, you can debug your script using the Debug command. With the Debug command, you can run a specific function in your script, or an entire script, through a debugging interface.
To select which function in which script the Debug command should debug, you must use the Set Target command, which will prompt you to select a script and a function. Once you've done this, every time you use the Debug command, it will debug the function you set as your target. If you need to debug a different function or script later, you will have to use the Set Target command again to change the target script and function. This allows you to work on and repeatedly debug one function at a time when working on a script.
- If you use the Debug command without setting a target first, you will be prompted to set a target. The selected target will persist until you use the Set Target command to change it.
- The target script and function is also used by the Run command.
- To debug a script from the global scope rather than debugging a specific function, you can select <Nothing> as the target function.
- Although you can run a script at the global scope, you cannot create a toolbar button that runs a script at the global scope. Toolbar buttons can only run specific functions within a script. Hence, debugging a script at the global scope should be done for testing purposes only.
- If you are currently editing the script you want to debug, save it by clicking on the Save button underneath the editor.
-
Do one of the following:
- In the Script Editor toolbar, click on the Set Target button.
- In the top-left corner of the Script Editor, click on the Menu button and select Play/Debug > SetTarget.
A dialog appears listing all the scripts as well as all the functions in the current script.
- In the Files list of the dialog, select the script you want to debug.
- In the Functions list of the dialog, select the function you want to debug.
-
NOTE If you want to debug the whole script from the global scope, select the <Nothing> function.
- Do one of the following to execute the target function:
- In the Script Editor toolbar, click on the Run button.
- In the top-left corner of the Script Editor, click on the Menu button and select Play/Debug > Debug.
The Qt Script Debugger opens. In it, you will find standard debugging controls.