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.
import { saveBaselineScreenshot } from "@qawolf/testkit";await saveBaselineScreenshot(page, "revenue-chart");
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.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"QA Wolf Docs","colors":{"primary":"#3b3cef","light":"#08edcb","dark":"#3b3cef"},"logo":{"light":"https://mintcdn.com/qawolf/8HFRRs7AoYV9S40R/logo/light.svg?fit=max\u0026auto=format\u0026n=8HFRRs7AoYV9S40R\u0026q=85\u0026s=b9d699b988c7eab072287836c4d9e0d2","dark":"https://mintcdn.com/qawolf/8HFRRs7AoYV9S40R/logo/dark.svg?fit=max\u0026auto=format\u0026n=8HFRRs7AoYV9S40R\u0026q=85\u0026s=cd2ad525ee7dd964ff4836f7df8d2b54","href":"https://www.qawolf.com"},"favicon":{"light":"https://mintcdn.com/qawolf/R2NspCz4NaCGUkW7/favicon.png?fit=max\u0026auto=format\u0026n=R2NspCz4NaCGUkW7\u0026q=85\u0026s=d25b1eaf526daf1590d54c42755028a3","dark":"https://mintcdn.com/qawolf/R2NspCz4NaCGUkW7/favicon.png?fit=max\u0026auto=format\u0026n=R2NspCz4NaCGUkW7\u0026q=85\u0026s=d25b1eaf526daf1590d54c42755028a3"},"appearance":{"default":"dark"},"background":{"decoration":"gradient","color":{"dark":"#0b0b2f"}},"navbar":{"links":[{"href":"mailto:hello@qawolf.com","label":"Support"},{"href":"https://app.qawolf.com/sign-in","label":"Sign in"}],"primary":{"type":"button","label":"Try for free","href":"https://qawolf.com"}},"footer":{"socials":{"x":"https://twitter.com/qawolfhq","github":"https://github.com/qawolf/qawolf","linkedin":"https://www.linkedin.com/company/qa-wolf"}},"seo":{"metatags":{"canonical":"https://docs.qawolf.com"}},"icons":{"library":"lucide"},"integrations":{"posthog":{"apiKey":"phc_qEW3U4XMuhdJa6Rf2QZvbyKcixM5mYyq5BYNopuSxBFw","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"qawolf","hasAudioNarration":false,"actualSubdomain":"qawolf","customDomains":["docs.qawolf.com"],"gitSource":{"type":"github","owner":"qawolf","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af65ff536537490d33132a4","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"References","count":43},{"language":"default","tag":"Solutions","count":37},{"language":"default","tag":"Integrations","count":34},{"language":"default","tag":"Features","count":15},{"language":"default","tag":"CI/CD","count":10},{"language":"default","tag":"@qawolf/flows","count":10},{"language":"default","tag":"Legacy triggers","count":9},{"language":"default","tag":"Agentic QA","count":7},{"language":"default","tag":"Audio","count":7},{"language":"default","tag":"Deployment testing","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"hello@qawolf.com"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"libraries/testkit/troubleshooting","slug":"/libraries/testkit/troubleshooting","pageMetadata":{"title":"Troubleshooting","description":"Troubleshoot common @qawolf/testkit problems, including missing client configuration and baseline screenshot errors during flow runs.","sidebarTitle":"Troubleshooting","href":"/libraries/testkit/troubleshooting"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Troubleshoot common @qawolf/testkit problems, including missing client configuration and baseline screenshot errors during flow runs.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`helper-throws-because-no-client-is-configured`,children:`Helper throws because no client is configured`}),`\n`,_jsx(_components.p,{children:`Cause: The flow called a client-dependent helper before the runner configured the testkit client.`}),`\n`,_jsx(_components.p,{children:`Check:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`the runner calls `,_jsx(_components.code,{children:`configureTestkitClient(...)`}),` before flow execution`]}),`\n`,_jsxs(_components.li,{children:[`tests call `,_jsx(_components.code,{children:`resetTestkitClient()`}),` between cases`]}),`\n`]}),`\n`,_jsxs(Heading,{level:`2`,id:`savebaselinescreenshot-throws`,children:[_jsx(_components.code,{children:`saveBaselineScreenshot()`}),` throws`]}),`\n`,_jsxs(_components.p,{children:[`Cause: The configured client was created without `,_jsx(_components.code,{children:`saveSnapshot`}),`.`]}),`\n`,_jsx(_components.p,{children:`Check:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`the runtime passed snapshot support into `,_jsx(_components.code,{children:`createTestkitClient(...)`})]}),`\n`]}),`\n`,_jsxs(Heading,{level:`2`,id:`qr-code-helper-returns-undefined`,children:[`QR code helper returns `,_jsx(_components.code,{children:`undefined`})]}),`\n`,_jsx(_components.p,{children:`Check:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`the selected element actually contains a QR code`}),`\n`,_jsx(_components.li,{children:`the screenshot is stable and large enough to decode reliably`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`update-a-baseline-screenshot-programmatically`,children:`Update a baseline screenshot programmatically`}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.code,{children:`saveBaselineScreenshot`}),` to the flow temporarily, run it once to save the new baseline, then remove it.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`saveBaselineScreenshot`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@qawolf/testkit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` saveBaselineScreenshot`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`page`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"revenue-chart\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The name must exactly match the name used in the corresponding `,_jsx(_components.code,{children:`toHaveScreenshot`}),` call. Remove this line once the baseline has been updated — it is not meant to run in normal test execution.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Troubleshooting","description":"Troubleshoot common @qawolf/testkit problems, including missing client configuration and baseline screenshot errors during flow runs.","sidebarTitle":"Troubleshooting","href":"/libraries/testkit/troubleshooting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Helper throws because no client is configured","slug":"helper-throws-because-no-client-is-configured","depth":2,"children":[]},{"title":"saveBaselineScreenshot() throws","slug":"savebaselinescreenshot-throws","depth":2,"children":[]},{"title":"QR code helper returns undefined","slug":"qr-code-helper-returns-undefined","depth":2,"children":[]},{"title":"Update a baseline screenshot programmatically","slug":"update-a-baseline-screenshot-programmatically","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/qawolf/31405aa6fa182398/qawolf-attribution-handler.js","/_mintlify/custom/qawolf/ded78afb53673389/qawolf-signup-handler.js","/_mintlify/custom/qawolf/e00fee94bfdab7ef/posthog_utils.js"],"subdomain":"qawolf","siteName":"QA Wolf Docs","title":"Troubleshooting - QA Wolf Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-16T00:05:46.572Z","gitLastModified":"2026-09-16T00:05:00.000Z","originalFileLocation":"libraries/testkit/troubleshooting.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Troubleshoot common @qawolf/testkit problems, including missing client configuration and baseline screenshot errors during flow runs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"QA Wolf Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Troubleshooting - QA Wolf Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Troubleshoot common @qawolf/testkit problems, including missing client configuration and baseline screenshot errors during flow runs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"QA Wolf Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.qawolf.com/libraries/testkit/troubleshooting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://qawolf.mintlify.site/_mintlify/api/og/v2?division=%40qawolf%2Ftestkit\u0026amp;title=Troubleshooting\u0026amp;description=Troubleshoot+common+%40qawolf%2Ftestkit+problems%2C+including+missing+client+configuration+and+baseline+screenshot+errors+during+flow+runs.\u0026amp;theme=eaef7bfce024a69feee67dd8\u0026amp;signature=e78379bef5a98f1138b675c058d267f543b4af3511444c1f0e8f4eae498a5609\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Troubleshooting - QA Wolf Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Troubleshoot common @qawolf/testkit problems, including missing client configuration and baseline screenshot errors during flow runs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qawolf.mintlify.site/_mintlify/api/og/v2?division=%40qawolf%2Ftestkit\u0026amp;title=Troubleshooting\u0026amp;description=Troubleshoot+common+%40qawolf%2Ftestkit+problems%2C+including+missing+client+configuration+and+baseline+screenshot+errors+during+flow+runs.\u0026amp;theme=eaef7bfce024a69feee67dd8\u0026amp;signature=e78379bef5a98f1138b675c058d267f543b4af3511444c1f0e8f4eae498a5609\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/qawolf/YyZP4y1fCTI_w0fv/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"QA Wolf Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3b3cef\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.qawolf.com/libraries/testkit/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/libraries/testkit/troubleshooting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.qawolf.com/#organization\",\"name\":\"QA Wolf Docs\",\"url\":\"https://docs.qawolf.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/qawolf/8HFRRs7AoYV9S40R/logo/light.svg?fit=max\u0026auto=format\u0026n=8HFRRs7AoYV9S40R\u0026q=85\u0026s=b9d699b988c7eab072287836c4d9e0d2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.qawolf.com#website\",\"name\":\"QA Wolf Docs\",\"url\":\"https://docs.qawolf.com\",\"publisher\":{\"@id\":\"https://docs.qawolf.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.qawolf.com/libraries/testkit/troubleshooting#webpage\",\"url\":\"https://docs.qawolf.com/libraries/testkit/troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"Troubleshoot common @qawolf/testkit problems, including missing client configuration and baseline screenshot errors during flow runs.\",\"dateModified\":\"2026-09-16T00:05:00.000Z\",\"isPartOf\":{\"@id\":\"https://docs.qawolf.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.qawolf.com/libraries/testkit/troubleshooting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.qawolf.com/libraries/testkit/troubleshooting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"@qawolf/testkit\",\"item\":\"https://docs.qawolf.com/libraries/testkit/api-reference/core\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Troubleshooting\",\"item\":\"https://docs.qawolf.com/libraries/testkit/troubleshooting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.qawolf.com/libraries/testkit/troubleshooting#article\",\"headline\":\"Troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"Troubleshoot common @qawolf/testkit problems, including missing client configuration and baseline screenshot errors during flow runs.\",\"url\":\"https://docs.qawolf.com/libraries/testkit/troubleshooting\",\"mainEntityOfPage\":{\"@id\":\"https://docs.qawolf.com/libraries/testkit/troubleshooting#webpage\"},\"dateModified\":\"2026-09-16T00:05:00.000Z\",\"publisher\":{\"@id\":\"https://docs.qawolf.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.qawolf.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"QA Wolf Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"QA Wolf Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/libraries/testkit/troubleshooting.md","siteName":"QA Wolf Docs","nav":{"global":null,"tabs":[{"tab":"Start","pages":[{"title":"Start","href":""}]},{"tab":"Features","pages":[{"title":"Features","href":"/product-mapping"}]},{"tab":"Solutions","pages":[{"title":"Solutions","href":"/solutions"}]},{"tab":"References","pages":[{"group":"Flow conventions","pages":[{"title":"Anatomy of a flow","href":"/anatomy-of-a-flow"},{"title":"Keep a flow going past a failed check","sidebarTitle":"Soft checks","href":"/soft-checks"},{"title":"Lint rules","href":"/lint-rules"}]},{"group":"@qawolf/flows","pages":[{"title":"Top-Level","sidebarTitle":"Top-Level","href":"/libraries/flows/api-reference/top-level"},{"title":"Web","sidebarTitle":"Web","href":"/libraries/flows/api-reference/web"},{"title":"Node Reference","sidebarTitle":"Node","href":"/libraries/flows/api-reference/cli"},{"title":"Android","sidebarTitle":"Android","href":"/libraries/flows/api-reference/android"},{"title":"Android Device Controls","href":"/libraries/flows/api-reference/android-device-reference"},{"title":"iOS","sidebarTitle":"iOS","href":"/libraries/flows/api-reference/ios"},{"title":"iOS Device Controls","href":"/libraries/flows/api-reference/ios-device-reference"},{"title":"iOS Device Pools","sidebarTitle":"Device Pools","href":"/libraries/flows/api-reference/ios-device-pools"},{"title":"Windows","sidebarTitle":"Windows","href":"/libraries/flows/api-reference/windows"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/libraries/flows/troubleshooting"}]},{"group":"@qawolf/pom","pages":[{"title":"POM Reference","sidebarTitle":"POM Reference","href":"/libraries/pom/api-reference/index"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/libraries/pom/troubleshooting"}]},{"group":"@qawolf/testkit","pages":[{"title":"Core","sidebarTitle":"Core","href":"/libraries/testkit/api-reference/core"},{"title":"Types","sidebarTitle":"Types","href":"/libraries/testkit/api-reference/types"},{"title":"Web","sidebarTitle":"Web","href":"/libraries/testkit/api-reference/web"},{"title":"Client","description":"Reference for @qawolf/testkit/client, the runner-facing entry point used to create and configure the testkit client for flow helpers.","sidebarTitle":"Client","href":"/libraries/testkit/api-reference/client"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/libraries/testkit/troubleshooting"}]},{"group":"@qawolf/emails","pages":[{"title":"Mail","description":"Reference for the @qawolf/emails mail API, covering inbox creation, sending messages, and waiting for parsed emails inside flows.","sidebarTitle":"Mail","href":"/libraries/emails/api-reference/mail"},{"title":"Client","sidebarTitle":"Client","href":"/libraries/emails/api-reference/client"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/libraries/emails/troubleshooting"}]},{"group":"@qawolf/cli","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/libraries/cli/api-reference/index"},{"title":"Commands Reference","sidebarTitle":"Commands","href":"/libraries/cli/api-reference/commands"},{"title":"Drive a runner","sidebarTitle":"Drive a runner","href":"/libraries/cli/drive-a-runner"},{"title":"Environment Variables","sidebarTitle":"Environment Variables","href":"/libraries/cli/api-reference/environment-variables"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/libraries/cli/troubleshooting"}]},{"group":"Local execution","pages":[{"title":"Get started with the QA Wolf CLI","sidebarTitle":"Get started","href":"/local-execution/get-started"},{"title":"Authenticate the QA Wolf CLI","sidebarTitle":"Authenticate","href":"/local-execution/authenticate"},{"title":"Run flows locally","sidebarTitle":"Run flows locally","href":"/local-execution/run-flows-locally"},{"title":"Set up a local-only project","sidebarTitle":"Set up a project","href":"/local-execution/set-up-a-project"},{"title":"Diagnose problems running flows","sidebarTitle":"Diagnose problems","href":"/local-execution/diagnose-problems"}]},{"group":"@qawolf/ci-sdk","pages":[{"title":"SDK Reference","sidebarTitle":"SDK Reference","href":"/libraries/ci-sdk/api-reference"},{"title":"Troubleshooting","href":"/libraries/ci-sdk/troubleshooting"}]},{"group":"Triggers","pages":[{"title":"Trigger fields","sidebarTitle":"Trigger fields","href":"/triggers/reference"},{"title":"Deployments","sidebarTitle":"Deployments","href":"/triggers/deployments"},{"title":"Migrate from legacy triggers","sidebarTitle":"Migrate from legacy triggers","href":"/triggers/migrate-from-legacy-triggers"}]},{"group":"REST","pages":[{"title":"Overview","href":"/rest-overview"},{"title":"v0/run-inputs-executables-signed-urls","sidebarTitle":"Upload a build (legacy)","href":"/run-inputs-executables-signed-urls"},{"title":"webhooks/deploy_success","sidebarTitle":"Notify a deploy (legacy)","href":"/deploy-success"},{"title":"v0/ci-greenlight","sidebarTitle":"Check run results","href":"/v0-ci-greenlight"},{"title":"webhooks/environment_terminated","sidebarTitle":"Terminate an environment","href":"/environment_terminated"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"Full Service","pages":[{"title":"Full Service","href":"/onboarding-to-full-service"}]}]},"basePath":"","title":"Troubleshooting - QA Wolf Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}