Debugging

June 10, 2026 ยท View on GitHub

Individual tests

Individual tests are specified in JSON files in the repository, and their execution can be controlled by editing the JSON file relevant to a given test.

For example, to enable debugging output on a given test, add "debug": true to a given test file, like below:

{
+  "debug": true,
  "proposals": [
    "sockets"
  ],
  "operations": [
    {
      "type": "run"
    },
    {
      "type": "wait"
    }
  ]
}

Adding this configuration will pass through DEBUG=true as an environment variable to the runner that is being used by the relevant tests, which should enable more output (stdin, stdout, files, etc) which should be helpful wile debugging.