Restart VS Code and open the folder containing the project you want to work on.
Note: with Visual Studio Code 1.31.1 and above, restart may not be required.
Using the debugger
When your launch config is set up, you can debug your project. Pick a launch config from the dropdown on the Debug pane in Code. Press the play button or F5 to start.
Configuration
In your project, go to the debugger and click the little gear icon and choose ExtendScript Debug. A new launch configuration will be created for you with following configuration:
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "1.0.0",
"configurations": [
{
"type": "extendscript-debug",
"request": "launch",
"name": "Ask for script name",
"program": "${workspaceFolder}/${command:AskForScriptName}",
"stopOnEntry": false
}
]
}
Add the configuration needed from the supported launch.json settings below and save the launch.json file.
Supported launch.json settings:
Property
Type
Description
Default Value
program
string
Absolute path to a script. You can set this to a specific file or debug driver script if you don't wish to be prompted each time for a file to execute. (E.g., ${workspaceFolder}/debug.jsx)
${workspaceFolder}/${command:AskForScriptName}
cwd
string
Absolute path to the directory of the program being debugged.
${workspaceFolder}
targetSpecifier
string
The target specifier in which the program will be debugged.
empty
engineName
string
The engine name in which the program will be debugged. For custom names, a new engine will be created depending upon the support provided by Adobe's applications
main
targetStartedSession
boolean
For internal use. Session target started.
false
breakXML
string
For Internal use. The break XML in case target started the session.
""
excludes
array
Excludes from variable display. Can be any combination of 'undefined', 'builtin', 'Function', 'prototype'.
Enter the maximum number of array elements to display.
20
trace
boolean
Enable logging of the ExtendScript debug session.
true
traceString
string
Enable extended logging of the ExtendScript debug adapter. Should be one of 'V', 'L', 'W', 'E'. This stands for Verbose, Log, Warn and Error respectively.
""
logFile
string
Enable logging of the ExtendScript debug session in this log file(Absolute Path).
