Skip to content

docs: document the headless: false validation error for Playwright Check Suites - #784

Merged
hlenke merged 1 commit into
mainfrom
hannes/pcs-headless-troubleshooting
Nov 3, 2026
Merged

hlenke merged 1 commit into
mainfrom
hannes/pcs-headless-troubleshooting

Conversation

@hlenke

@hlenke hlenke commented Nov 2, 2026

Copy link
Copy Markdown
Member

Affected Components

  • Content & Marketing
  • Pricing
  • Test
  • Docs
  • Learn
  • Other

Notes for the Reviewer

This adds one entry under Common issues & troubleshooting → Configuration errors in detect/synthetic-monitoring/playwright-checks/configuration.mdx: "headless: false is not supported", with the exact error message and the fix.

Where it comes from. It's taken from the unmerged branch mda-troubleshooting-section (#154). That branch said Checkly ignores headless: false and suggested headless: process.env.CHECKLY ? true : false as a workaround. Current CLI behaviour is different:

  • checkly@10.1.0 rejects headless: false in use or in any project (validateHeadlessMode in constructs/playwright-check).
  • I verified it on a minimal project with npx checkly test --list. With the conditional value, validation fails: the CLI reads the config on your machine, where CHECKLY isn't set. Without the setting, the same project validates. The error block in this PR is the CLI's actual output.

The rest of that branch is already on this page ("webServer configuration requires additional files", "No tests found"), so nothing else carries over. The branch is being deleted.

Not included: that branch also added multistep-checks/troubleshooting to the nav. That page is on main but isn't in the nav. I left it out on purpose: its content is generic ("Implement token refresh logic", "Add monitoring for long-running operations"), and adding it to the nav would make it more visible. It should be rewritten or deleted with a redirect, in a separate change.

🤖 Generated with Claude Code

…eck Suites

The CLI rejects headless: false in use or in any project of
playwright.config.ts (checkly 10.1.0, "headless: false is not
supported"). It reads the config locally, so a value based on
process.env.CHECKLY fails validation too. Verified with
`npx checkly test --list` on a minimal project.

Comes from the unmerged troubleshooting branch of #154, whose
suggested workaround (headless: process.env.CHECKLY ? true : false)
no longer passes validation.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
checkly-422f444a 🟢 Ready View Preview Nov 2, 2026, 11:58 PM

@hlenke
hlenke marked this pull request as ready for review November 3, 2026 00:00
@hlenke
hlenke merged commit 54c23c8 into main Nov 3, 2026
9 checks passed
@hlenke
hlenke deleted the hannes/pcs-headless-troubleshooting branch November 3, 2026 00:01

This branch was successfully deployed

1 active deployment
staging — e17d477a Deployed Nov 2, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant