Integration with the Visual Studio "Script Documents" Tree

If a debug adapter supports dynamically loading documents (e.g. script files consumed by a JavaScript runtime), it can provide information regarding these documents to Visual Studio. These documents are shown under a "Script Documents" node in Solution Explorer.

Required Implementation

To take advantage of this integration, debug adapters must:

• Send a loadedSource event when a script document is loaded or unloaded.

Remarks

If the loaded document corresponds to an item in the user's project, the sourceReference field should not be specified. Visual Studio will always treat items that specify a non-zero sourceReference as external.