chore: Add launch.template.json for debugging tests (#9599)

.eslintignore

@@ -22,6 +22,8 @@ generated/
 
 # IDE Artifacts
 .vscode
+!.vscode/extensions.json
+!.vscode/*.template.json
 .devcontainer
 
 # Misc

.gitignore

@@ -22,6 +22,7 @@ generated/
 # IDE Artifacts
 .vscode/*
 !.vscode/extensions.json
+!.vscode/*.template.json
 .devcontainer
 
 # Misc

.prettierignore

@@ -23,6 +23,7 @@ generated/
 # IDE Artifacts
 .vscode/*
 !.vscode/extensions.json
+!.vscode/*.template.json
 .devcontainer
 
 # Misc

.vscode/launch.template.json

@@ -0,0 +1,43 @@
+{
+  // 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": "0.2.0",
+  "inputs": [
+    {
+      "type": "pickString",
+      "id": "suit",
+      "description": "Which test suit to run?",
+      "options": [
+        "chrome-headless",
+        "chrome-headful",
+        "chrome-new-headless",
+        "firefox-headless",
+        "firefox-headful",
+        "firefox-bidi",
+        "chrome-bidi"
+      ],
+      "default": "chrome-headless"
+    }
+  ],
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Launch Tests",
+      "skipFiles": ["<node_internals>/**"],
+      "runtimeExecutable": "npm",
+      "cwd": "${workspaceFolder}",
+      "runtimeArgs": [
+        "run-script",
+        "test",
+        "--",
+        "--test-suite",
+        "${input:suit}",
+        "--no-coverage",
+        "--no-suggestions"
+      ],
+      "outFiles": ["${workspaceFolder}/**/*.js"]
+    }
+  ]
+}

docs/contributing.md

@@ -264,6 +264,16 @@ ensure this, the main `test` command runs coverage during testing.
 
 See [Debugging Tips](https://pptr.dev/guides/debugging).
 
+### Debugging Puppeteer tests via VSCode
+
+Copy the provided default `.vscode/launch.template.json` to `.vscode/launch.json` and then use the integrated VSCode debugger to debug test.
+
+Remember to build test before launching via:
+
+```sh
+npm run build --workspace @puppeteer-test/test
+```
+
 # For Project Maintainers
 
 ## Rolling new Chromium version