Add launch config for running an e2e test

Author: unstubbable

.vscode/launch.json

@@ -16,6 +16,13 @@
       "description": "Select the next command",
       "options": ["dev", "build", "start"],
       "default": "dev"
+    },
+    {
+      "id": "nextTestMode",
+      "type": "pickString",
+      "description": "Select the next test mode",
+      "options": ["dev", "start"],
+      "default": "dev"
     }
   ],
   "configurations": [
@@ -198,6 +205,28 @@
         "NEXT_TELEMETRY_DISABLED": "1"
       }
     },
+    {
+      "name": "Run e2e test",
+      "type": "node",
+      "request": "launch",
+      "cwd": "${workspaceFolder}",
+      "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/jest",
+      "runtimeArgs": ["--runInBand", "--verbose", "${file}"],
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"],
+      "sourceMapPathOverrides": {
+        "webpack://_N_E/[.]/(app|pages)/(.*)": "${workspaceFolder}/${fileDirname}/$1/$2",
+        "webpack://_N_E/[.]/(.*)": "${workspaceFolder}/${fileDirname}/.next/server/$1",
+        "webpack://_N_E/(?:../)*src/(.*)": "${workspaceFolder}/packages/next/src/$1",
+        "webpack://next/./dist/src/*": "${workspaceFolder}/packages/next/src/*"
+      },
+      "env": {
+        "HEADLESS": "true",
+        "NEXT_E2E_TEST_TIMEOUT": "1000000",
+        "NEXT_SKIP_ISOLATE": "1",
+        "NEXT_TEST_MODE": "${input:nextTestMode}"
+      }
+    },
     {
       "name": "Launch app build trace jaeger",
       "type": "node",

contributing/core/vscode-debugger.md

@@ -8,6 +8,7 @@ The common configurations are:
 
 - **Launch app**: Run `next dev`, `next build`, or `next start` in a directory of your choice, with an attached debugger.
 - **Launch current directory**: Run `next dev`, `next build`, or `next start` in the directory of the currently active file, with an attached debugger.
+- **Run e2e test**: Run an e2e test using the currently active file, with an attached debugger.
 
 ### Run a specific app