microsoft/vscode-mock-debug

microsoft/vscode-mock-debug

Description: Starter sample for developing debug adapters for VSCode.

Language: TypeScript

License: NOASSERTION

Stars: 356

Forks: 197

Open issues: 18

Created: 2015-10-07T09:21:19Z

Pushed: 2026-06-14T01:04:52Z

Default branch: main

Fork: no

Archived: no

README:

VS Code Mock Debug

This is a starter sample for developing VS Code debug adapters.

Mock Debug simulates a debug adapter for Visual Studio Code. It supports *step*, *continue*, *breakpoints*, *exceptions*, and *variable access* but it is not connected to any real debugger.

The sample is meant as an educational piece showing how to implement a debug adapter for VS Code. It can be used as a starting point for developing a real adapter.

More information about how to develop a new debug adapter can be found here.

Using Mock Debug

• Install the Mock Debug extension in VS Code.
• Create a new 'program' file readme.md and enter several lines of arbitrary text.
• Switch to the debug viewlet and press the gear dropdown.
• Select the debug environment "Mock Debug".
• Press the green 'play' button to start debugging.

You can now 'step through' the readme.md file, set and hit breakpoints, and run into exceptions (if the word exception appears in a line).


Build and Run

• Clone the project https://github.com/Microsoft/vscode-mock-debug.git
• Open the project folder in VS Code.
• Press F5 to build and launch Mock Debug in another VS Code window.
• In the explorer view of the new window open the 'program' file readme.md
• Set some breakpoints
• From the editor's "Run and Debug" toolbar dropdown menu select "Debug File"