Skip to content

Adding info force click #2109

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Oct 31, 2025
Merged

Adding info force click #2109

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
7acacd5
Enhance click options documentation with force warning
TheComeUpCode Oct 30, 2025
9f36bca
Update click options to warn against force usage
TheComeUpCode Oct 30, 2025
21e60a7
Update click options to include force usage warning
TheComeUpCode Oct 30, 2025
fe16627
Update click options to include warning for 'force'
TheComeUpCode Oct 30, 2025
5c547c9
Update link to cookie banner interference documentation
TheComeUpCode Oct 30, 2025
91d32fa
Update timeout option link in click.md
TheComeUpCode Oct 30, 2025
75d18f8
Fix link formatting in click.md documentation
TheComeUpCode Oct 30, 2025
588684d
Fix link in options.force description
TheComeUpCode Oct 30, 2025
0c7c355
Update timeout option documentation for clarity
TheComeUpCode Oct 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/sources/k6/next/javascript-api/k6-browser/elementhandle/click.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Mouse click on the chosen element.
| options.button | string | `left` | The mouse button (`left`, `middle` or `right`) to use during the action. |
| options.clickCount | number | `1` | The number of times the action is performed. |
| options.delay | number | `0` | Milliseconds to wait between `mousedown` and `mouseup`. |
| options.force | boolean | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`). |
| options.force | boolean | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`). Avoid using `force: true` in `click` actions, as it may mask underlying test design or app issues. It bypasses normal user interaction checks, and elements may not be clickable due to [cookie banner interference](https://grafana.com/docs/k6/<K6_VERSION>/using-k6-browser/recommended-practices/prevent-cookie-banners-blocking/). |
| options.modifiers | string[] | `null` | `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the action. If not specified, currently pressed modifiers are used. |
| options.noWaitAfter | boolean | `false` | If set to `true` and a navigation occurs from performing this action, it will not wait for it to complete. |
| options.position | object | `null` | A point to use relative to the top left corner of the element. If not supplied, a visible point of the element is used. |
Expand Down
2 changes: 1 addition & 1 deletion docs/sources/k6/next/javascript-api/k6-browser/frame/click.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ This method clicks on an element matching a `selector`.
| options.button | string | `left` | The mouse button (`left`, `middle` or `right`) to use during the action. |
| options.clickCount | number | `1` | The number of times the action is performed. |
| options.delay | number | `0` | Milliseconds to wait between `mousedown` and `mouseup`. |
| options.force | boolean | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`). |
| options.force | boolean | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`). Avoid using `force: true` in `click` actions, as it may mask underlying test design or app issues. It bypasses normal user interaction checks, and elements may not be clickable due to [cookie banner interference](https://grafana.com/docs/k6/<K6_VERSION>/using-k6-browser/recommended-practices/prevent-cookie-banners-blocking/). |
| options.modifiers | string[] | `null` | `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the action. If not specified, currently pressed modifiers are used. |
| options.noWaitAfter | boolean | `false` | If set to `true` and a navigation occurs from performing this action, it will not wait for it to complete. |
| options.position | object | `null` | A point to use relative to the top left corner of the element. If not supplied, a visible point of the element is used. |
Expand Down
2 changes: 1 addition & 1 deletion docs/sources/k6/next/javascript-api/k6-browser/locator/click.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Mouse click on the chosen element.
| options.button | string | `left` | The mouse button (`left`, `middle` or `right`) to use during the action. |
| options.clickCount | number | `1` | The number of times the action is performed. |
| options.delay | number | `0` | Milliseconds to wait between `mousedown` and `mouseup`. |
| options.force | boolean | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`). |
| options.force | boolean | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`). Avoid using `force: true` in `click` actions, as it may mask underlying test design or app issues. It bypasses normal user interaction checks, and elements may not be clickable due to [cookie banner interference](https://grafana.com/docs/k6/latest/using-k6-browser/recommended-practices/prevent-cookie-banners-blocking/). |
| options.modifiers | string[] | `null` | `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the action. If not specified, currently pressed modifiers are used. |
| options.noWaitAfter | boolean | `false` | If set to `true` and a navigation occurs from performing this action, it will not wait for it to complete. |
| options.position | object | `null` | A point to use relative to the top left corner of the element. If not supplied, a visible point of the element is used. |
Expand Down
2 changes: 1 addition & 1 deletion docs/sources/k6/next/javascript-api/k6-browser/page/click.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ This method clicks on an element matching a `selector`.
| options.button | string | `left` | The mouse button (`left`, `middle` or `right`) to use during the action. |
| options.clickCount | number | `1` | The number of times the action is performed. |
| options.delay | number | `0` | Milliseconds to wait between `mousedown` and `mouseup`. |
| options.force | boolean | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`). |
| options.force | boolean | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`). Avoid using `force: true` in `click` actions, as it may mask underlying test design or app issues. It bypasses normal user interaction checks, and elements may not be clickable due to [cookie banner interference](https://grafana.com/docs/k6/<K6_VERSION>/using-k6-browser/recommended-practices/prevent-cookie-banners-blocking/). |
| options.modifiers | string[] | `null` | `Alt`, `Control`, `Meta` or `Shift` modifiers keys pressed during the action. If not specified, currently pressed modifiers are used. |
| options.noWaitAfter | boolean | `false` | If set to `true` and a navigation occurs from performing this action, it will not wait for it to complete. |
| options.position | object | `null` | A point to use relative to the top left corner of the element. If not supplied, a visible point of the element is used. |
Expand Down
Loading