Recipe to debug with VSCode

docs/recipes/debugging-with-vscode.md

@@ -0,0 +1,31 @@
+# Debugging tests with Visual Studio Code
+
+## Setup
+
+In the sidebar click the `Debug` handle.
+
+Add a new configuration in the dropdown menu next to the green `Debug` button: `Add configuration`. This will open `launch.json` with all debug configurations.
+
+Add following to the `configurations` object:
+
+```json
+{
+    "type": "node",
+    "request": "launch",
+    "name": "Run AVA test",
+    "program": "${workspaceRoot}/node_modules/ava/profile.js",
+    "args": [
+      "${file}"
+    ]
+}
+```
+
+Save this configuration after you added it.
+
+## Debug
+
+> **Note:** The file you want to debug, must be open and active
+
+Set breakpoints in the code.
+
+Hit the green `Debug` button next to the list of configurations on the top left in the `Debug` view. Once the breakpoint is hit, you can evaluate variables and step through the code.

readme.md

@@ -203,6 +203,7 @@ $ node --inspect node_modules/ava/profile.js some/test/file.js
 
 - [Chrome DevTools](docs/recipes/debugging-with-chrome-devtools.md)
 - [WebStorm](docs/recipes/debugging-with-webstorm.md)
+- [Visual Studio Code](docs/recipes/debugging-with-vscode.md)
 
 
 ## Reporters