Errors

Every error type, what it means and how to fix it.

Errors

Every error has a type you can catch and a detail that explains the fix.

try {
	page.click( "Checkout" )
} catch ( "Playwright.Timeout" e ) {
	println( e.message & " / " & e.detail )
}
TypeWhenFix
Playwright.AssertionFailedAn assertion did not pass in timeRead expected/received in the message; raise timeouts.assertion if the page is slow
Playwright.TimeoutAn action waited too long for an elementCheck the selector (page.snapshot() helps); raise timeouts.action
Playwright.ActionFailedPlaywright refused an action (detached, not editable, navigation error, ...)The message has Playwright's call log
Playwright.InvalidOptionUnknown option, bad value, unknown method or deviceThe detail lists the valid values
Playwright.InvalidProfileUnknown profile or an extends loopThe detail lists the profiles
Playwright.NotInstalledDriver, Node.js, browser or bx-ai missingRun bxPlaywright install or bxPlaywright doctor
Playwright.NodeInstallFailedNode.js download or checksum failedCheck the network, use nodeDownloadURL or nodePath
Edit this page Download Markdown Last updated Sep 30, 2026, 7:24:11 PM