diff --git a/dev-packages/node-integration-tests/README.md b/dev-packages/node-integration-tests/README.md index c920f05d5e31..b2d8db2124d1 100644 --- a/dev-packages/node-integration-tests/README.md +++ b/dev-packages/node-integration-tests/README.md @@ -47,3 +47,20 @@ To run tests with Vitest's watch mode: To filter tests by their title: `yarn test -t "set different properties of a scope"` + +## Debugging Tests + +To enable verbose logging during test execution, set the `DEBUG` environment variable: + +`DEBUG=1 yarn test` + +When `DEBUG` is enabled, the test runner will output: + +- Test scenario startup information (path, flags, DSN) +- Docker Compose output when using `withDockerCompose` +- Child process stdout and stderr output +- HTTP requests made during tests +- Process errors and exceptions +- Line-by-line output from test scenarios + +This is particularly useful when debugging failing tests or understanding the test execution flow.