force click
Force-click a labeled element, bypassing actionability checks
Click a labeled element with Playwright Force: true, bypassing visibility / stability / receives-events checks. Escape hatch when a default click is blocked by an intercepting overlay.
Syntax
When I force click on "<target>" [by …]Qualifiers
| Qualifier | Role | Example |
|---|---|---|
on | Target label | force click on "Submit" |
by … | Optional find hint | force click on "submit" by data-testid |
Requirements
| Item | Contract |
|---|---|
| Element / control shape | General resolve first — same shapes as other labeled clicks. Force only bypasses Playwright actionability after resolve |
| How the label binds | Auto-find or by … |
| Qualifiers that change resolve | on + optional find hint |
| Platform | Web only (v1). Appium / api → unsupported |
| Wrong shape → use instead | Prefer default click when the control is actionable |
See also UI contracts.
Examples
When I force click on "Submit"Notes
- Does not change the default
click onpath — only this command forces the click. - Uses action resolve auto-wait (~30s), same contract as click.
- Web only for v1. Appium /
Platform: apireturn unsupported.