> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qawolf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Testkit Troubleshooting

> Troubleshoot common @qawolf/testkit problems, including missing client configuration and baseline screenshot errors during flow runs.

## Helper Throws Because No Client Is Configured

Cause: The flow called a client-dependent helper before the runner configured the testkit client.

Check:

* the runner calls `configureTestkitClient(...)` before flow execution
* tests call `resetTestkitClient()` between cases

## `saveBaselineScreenshot()` Throws

Cause: The configured client was created without `saveSnapshot`.

Check:

* the runtime passed snapshot support into `createTestkitClient(...)`

## QR Code Helper Returns `undefined`

Check:

* the selected element actually contains a QR code
* the screenshot is stable and large enough to decode reliably

## Update a baseline screenshot programmatically

If the QA Wolf editor doesn't let you promote a new screenshot as the updated baseline, you can do it in flow code instead. Add `saveBaselineScreenshot` to the flow temporarily, run it once to save the new baseline, then remove it.

```typescript theme={null}
import { saveBaselineScreenshot } from "@qawolf/testkit";

await saveBaselineScreenshot(page, "revenue-chart");
```

<Warning>
  The name must exactly match the name used in the corresponding `toHaveScreenshot` call. Remove this line once the baseline has been updated — it is not meant to run in normal test execution.
</Warning>