Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
TypeScript automationchromechromiume2e-testingelectronend-to-end-testingfirefoxjavascriptplaywrighttesttest-automationtestingtesting-toolswebwebkit
feat(actions): add scroll option to opt out of autoscroll (#41433)
Pavel Feldman1b3da20a34fa
diff --git a/docs/src/api/class-elementhandle.md b/docs/src/api/class-elementhandle.mdindex 47f622a536..10a862cfcf 100644--- a/docs/src/api/class-elementhandle.md+++ b/docs/src/api/class-elementhandle.md@@ -179,6 +179,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: ElementHandle.check.force = %%-input-force-%%* since: v1.8+### option: ElementHandle.check.scroll = %%-input-scroll-%%+* since: v1.62+### option: ElementHandle.check.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.8@@ -224,6 +227,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: ElementHandle.click.force = %%-input-force-%%* since: v1.8+### option: ElementHandle.click.scroll = %%-input-scroll-%%+* since: v1.62+### option: ElementHandle.click.noWaitAfter = %%-input-no-wait-after-%%* since: v1.8@@ -280,6 +286,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: ElementHandle.dblclick.force = %%-input-force-%%* since: v1.8+### option: ElementHandle.dblclick.scroll = %%-input-scroll-%%+* since: v1.62+### option: ElementHandle.dblclick.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.8@@ -593,6 +602,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: ElementHandle.hover.force = %%-input-force-%%* since: v1.8+### option: ElementHandle.hover.scroll = %%-input-scroll-%%+* since: v1.62+### option: ElementHandle.hover.timeout = %%-input-timeout-%%* since: v1.8@@ -935,6 +947,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: ElementHandle.setChecked.force = %%-input-force-%%* since: v1.15+### option: ElementHandle.setChecked.scroll = %%-input-scroll-%%+* since: v1.62+### option: ElementHandle.setChecked.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.15@@ -1000,6 +1015,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: ElementHandle.tap.force = %%-input-force-%%* since: v1.8+### option: ElementHandle.tap.scroll = %%-input-scroll-%%+* since: v1.62+### option: ElementHandle.tap.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.8@@ -1073,6 +1091,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: ElementHandle.uncheck.force = %%-input-force-%%* since: v1.8+### option: ElementHandle.uncheck.scroll = %%-input-scroll-%%+* since: v1.62+### option: ElementHandle.uncheck.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.8diff --git a/docs/src/api/class-frame.md b/docs/src/api/class-frame.mdindex 6f5ceedea9..28e7820b4a 100644--- a/docs/src/api/class-frame.md+++ b/docs/src/api/class-frame.md@@ -209,6 +209,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Frame.check.force = %%-input-force-%%* since: v1.8+### option: Frame.check.scroll = %%-input-scroll-%%+* since: v1.62+### option: Frame.check.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.8@@ -262,6 +265,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Frame.click.force = %%-input-force-%%* since: v1.8+### option: Frame.click.scroll = %%-input-scroll-%%+* since: v1.62+### option: Frame.click.modifiers = %%-input-modifiers-%%* since: v1.8@@ -320,6 +326,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Frame.dblclick.force = %%-input-force-%%* since: v1.8+### option: Frame.dblclick.scroll = %%-input-scroll-%%+* since: v1.62+### option: Frame.dblclick.delay = %%-input-down-up-delay-%%* since: v1.8@@ -461,6 +470,9 @@ Optional event-specific initialization properties.### option: Frame.dragAndDrop.force = %%-input-force-%%* since: v1.13+### option: Frame.dragAndDrop.scroll = %%-input-scroll-%%+* since: v1.62+### option: Frame.dragAndDrop.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.13@@ -1151,6 +1163,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Frame.hover.force = %%-input-force-%%* since: v1.8+### option: Frame.hover.scroll = %%-input-scroll-%%+* since: v1.62+### option: Frame.hover.strict = %%-input-strict-%%* since: v1.14@@ -1601,6 +1616,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Frame.setChecked.force = %%-input-force-%%* since: v1.15+### option: Frame.setChecked.scroll = %%-input-scroll-%%+* since: v1.62+### option: Frame.setChecked.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.15@@ -1692,6 +1710,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Frame.tap.force = %%-input-force-%%* since: v1.8+### option: Frame.tap.scroll = %%-input-scroll-%%+* since: v1.62+### option: Frame.tap.modifiers = %%-input-modifiers-%%* since: v1.8@@ -1800,6 +1821,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Frame.uncheck.force = %%-input-force-%%* since: v1.8+### option: Frame.uncheck.scroll = %%-input-scroll-%%+* since: v1.62+### option: Frame.uncheck.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.8diff --git a/docs/src/api/class-locator.md b/docs/src/api/class-locator.mdindex a7f1fbd9f1..fd0e717843 100644--- a/docs/src/api/class-locator.md+++ b/docs/src/api/class-locator.md@@ -354,6 +354,9 @@ await page.GetByRole(AriaRole.Checkbox).CheckAsync();### option: Locator.check.force = %%-input-force-%%* since: v1.14+### option: Locator.check.scroll = %%-input-scroll-%%+* since: v1.62+### option: Locator.check.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.14@@ -512,6 +515,9 @@ await page.Locator("canvas").ClickAsync(new() {### option: Locator.click.force = %%-input-force-%%* since: v1.14+### option: Locator.click.scroll = %%-input-scroll-%%+* since: v1.62+### option: Locator.click.noWaitAfter = %%-input-no-wait-after-%%* since: v1.14@@ -598,6 +604,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Locator.dblclick.force = %%-input-force-%%* since: v1.14+### option: Locator.dblclick.scroll = %%-input-scroll-%%+* since: v1.62+### option: Locator.dblclick.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.14@@ -894,6 +903,9 @@ Locator of the element to drag to.### option: Locator.dragTo.force = %%-input-force-%%* since: v1.18+### option: Locator.dragTo.scroll = %%-input-scroll-%%+* since: v1.62+### option: Locator.dragTo.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.18@@ -1553,6 +1565,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Locator.hover.force = %%-input-force-%%* since: v1.14+### option: Locator.hover.scroll = %%-input-scroll-%%+* since: v1.62+### option: Locator.hover.timeout = %%-input-timeout-%%* since: v1.14@@ -2446,6 +2461,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Locator.setChecked.force = %%-input-force-%%* since: v1.15+### option: Locator.setChecked.scroll = %%-input-scroll-%%+* since: v1.62+### option: Locator.setChecked.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.15@@ -2627,6 +2645,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Locator.tap.force = %%-input-force-%%* since: v1.14+### option: Locator.tap.scroll = %%-input-scroll-%%+* since: v1.62+### option: Locator.tap.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.14@@ -2741,6 +2762,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Locator.uncheck.force = %%-input-force-%%* since: v1.14+### option: Locator.uncheck.scroll = %%-input-scroll-%%+* since: v1.62+### option: Locator.uncheck.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.14diff --git a/docs/src/api/class-page.md b/docs/src/api/class-page.mdindex e16df91a4f..30c14dbe92 100644--- a/docs/src/api/class-page.md+++ b/docs/src/api/class-page.md@@ -745,6 +745,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Page.check.force = %%-input-force-%%* since: v1.8+### option: Page.check.scroll = %%-input-scroll-%%+* since: v1.62+### option: Page.check.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.8@@ -794,6 +797,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Page.click.force = %%-input-force-%%* since: v1.8+### option: Page.click.scroll = %%-input-scroll-%%+* since: v1.62+### option: Page.click.modifiers = %%-input-modifiers-%%* since: v1.8@@ -894,6 +900,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Page.dblclick.force = %%-input-force-%%* since: v1.8+### option: Page.dblclick.scroll = %%-input-scroll-%%+* since: v1.62+### option: Page.dblclick.delay = %%-input-down-up-delay-%%* since: v1.8@@ -1088,6 +1097,9 @@ await Page.DragAndDropAsync("#source", "#target", new()### option: Page.dragAndDrop.force = %%-input-force-%%* since: v1.13+### option: Page.dragAndDrop.scroll = %%-input-scroll-%%+* since: v1.62+### option: Page.dragAndDrop.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.13@@ -2481,6 +2493,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Page.hover.force = %%-input-force-%%* since: v1.8+### option: Page.hover.scroll = %%-input-scroll-%%+* since: v1.62+### option: Page.hover.modifiers = %%-input-modifiers-%%* since: v1.8@@ -4068,6 +4083,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Page.setChecked.force = %%-input-force-%%* since: v1.15+### option: Page.setChecked.scroll = %%-input-scroll-%%+* since: v1.62+### option: Page.setChecked.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.15@@ -4310,6 +4328,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Page.tap.force = %%-input-force-%%* since: v1.8+### option: Page.tap.scroll = %%-input-scroll-%%+* since: v1.62+### option: Page.tap.modifiers = %%-input-modifiers-%%* since: v1.8@@ -4422,6 +4443,9 @@ When all steps combined have not finished during the specified [`option: timeout### option: Page.uncheck.force = %%-input-force-%%* since: v1.8+### option: Page.uncheck.scroll = %%-input-scroll-%%+* since: v1.62+### option: Page.uncheck.noWaitAfter = %%-input-no-wait-after-removed-%%* since: v1.8diff --git a/docs/src/api/params.md b/docs/src/api/params.mdindex 1a59644289..8000f7e5ba 100644--- a/docs/src/api/params.md+++ b/docs/src/api/params.md@@ -80,6 +80,14 @@ This option has no effect.Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.+## input-scroll+- `scroll` <[ScrollMode]<"auto"|"none">>++Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`,+which scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+`"none"`, Playwright does not scroll the element and the action fails if the element is not already in the viewport.+This is useful to assert that an element is reachable by the user without additional scrolling.+## input-selector- `selector` <[string]>diff --git a/packages/playwright-client/types/types.d.ts b/packages/playwright-client/types/types.d.tsindex 5f01196f87..b215084259 100644--- a/packages/playwright-client/types/types.d.ts+++ b/packages/playwright-client/types/types.d.ts@@ -2138,6 +2138,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -2245,6 +2253,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -2384,6 +2400,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -2503,6 +2527,14 @@ export interface Page {*/noWaitAfter?: boolean;+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Clicks on the source element at this point relative to the top-left corner of the element's padding box. If not* specified, some visible point of the element is used.@@ -3330,6 +3362,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -4313,6 +4353,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -4574,6 +4622,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -4722,6 +4778,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -6243,6 +6307,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -6339,6 +6411,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -6435,6 +6515,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -6540,6 +6628,14 @@ export interface Frame {*/noWaitAfter?: boolean;+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Clicks on the source element at this point relative to the top-left corner of the element's padding box. If not* specified, some visible point of the element is used.@@ -7168,6 +7264,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -7702,6 +7806,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -7877,6 +7989,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -8025,6 +8145,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -11741,6 +11869,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -11825,6 +11961,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor* position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.@@ -11914,6 +12058,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor* position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.@@ -12088,6 +12240,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -12530,6 +12690,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -12658,6 +12826,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -12762,6 +12938,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -13244,6 +13428,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -13389,6 +13581,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor* position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.@@ -13512,6 +13712,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor* position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.@@ -13662,6 +13870,14 @@ export interface Locator {*/noWaitAfter?: boolean;+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Clicks on the source element at this point relative to the top-left corner of the element's padding box. If not* specified, some visible point of the element is used.@@ -14354,6 +14570,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -15026,6 +15250,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -15182,6 +15414,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -15304,6 +15544,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using thediff --git a/packages/playwright-core/src/client/channels.d.ts b/packages/playwright-core/src/client/channels.d.tsindex ea59dfbb58..c66c5f2b5f 100644--- a/packages/playwright-core/src/client/channels.d.ts+++ b/packages/playwright-core/src/client/channels.d.ts@@ -2462,6 +2462,7 @@ export type FrameCheckParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,timeout: number,trial?: boolean,@@ -2469,6 +2470,7 @@ export type FrameCheckParams = {export type FrameCheckOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,trial?: boolean,};@@ -2477,6 +2479,7 @@ export type FrameClickParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',noWaitAfter?: boolean,modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,@@ -2490,6 +2493,7 @@ export type FrameClickParams = {export type FrameClickOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',noWaitAfter?: boolean,modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,@@ -2509,6 +2513,7 @@ export type FrameDragAndDropParams = {source: string,target: string,force?: boolean,+ scroll?: 'auto' | 'none',timeout: number,trial?: boolean,sourcePosition?: Point,@@ -2518,6 +2523,7 @@ export type FrameDragAndDropParams = {};export type FrameDragAndDropOptions = {force?: boolean,+ scroll?: 'auto' | 'none',trial?: boolean,sourcePosition?: Point,targetPosition?: Point,@@ -2562,6 +2568,7 @@ export type FrameDblclickParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,delay?: number,@@ -2573,6 +2580,7 @@ export type FrameDblclickParams = {export type FrameDblclickOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,delay?: number,@@ -2693,6 +2701,7 @@ export type FrameHoverParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,timeout: number,@@ -2701,6 +2710,7 @@ export type FrameHoverParams = {export type FrameHoverOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,trial?: boolean,@@ -2912,6 +2922,7 @@ export type FrameTapParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,timeout: number,@@ -2920,6 +2931,7 @@ export type FrameTapParams = {export type FrameTapOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,trial?: boolean,@@ -2957,6 +2969,7 @@ export type FrameUncheckParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,timeout: number,trial?: boolean,@@ -2964,6 +2977,7 @@ export type FrameUncheckParams = {export type FrameUncheckOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,trial?: boolean,};@@ -3191,18 +3205,21 @@ export type ElementHandleBoundingBoxResult = {};export type ElementHandleCheckParams = {force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,timeout: number,trial?: boolean,};export type ElementHandleCheckOptions = {force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,trial?: boolean,};export type ElementHandleCheckResult = void;export type ElementHandleClickParams = {force?: boolean,+ scroll?: 'auto' | 'none',noWaitAfter?: boolean,modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,@@ -3215,6 +3232,7 @@ export type ElementHandleClickParams = {};export type ElementHandleClickOptions = {force?: boolean,+ scroll?: 'auto' | 'none',noWaitAfter?: boolean,modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,@@ -3232,6 +3250,7 @@ export type ElementHandleContentFrameResult = {};export type ElementHandleDblclickParams = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,delay?: number,@@ -3242,6 +3261,7 @@ export type ElementHandleDblclickParams = {};export type ElementHandleDblclickOptions = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,delay?: number,@@ -3281,6 +3301,7 @@ export type ElementHandleGetAttributeResult = {};export type ElementHandleHoverParams = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,timeout: number,@@ -3288,6 +3309,7 @@ export type ElementHandleHoverParams = {};export type ElementHandleHoverOptions = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,trial?: boolean,@@ -3470,6 +3492,7 @@ export type ElementHandleSetInputFilesOptions = {export type ElementHandleSetInputFilesResult = void;export type ElementHandleTapParams = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,timeout: number,@@ -3477,6 +3500,7 @@ export type ElementHandleTapParams = {};export type ElementHandleTapOptions = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,trial?: boolean,@@ -3498,12 +3522,14 @@ export type ElementHandleTypeOptions = {export type ElementHandleTypeResult = void;export type ElementHandleUncheckParams = {force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,timeout: number,trial?: boolean,};export type ElementHandleUncheckOptions = {force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,trial?: boolean,};diff --git a/packages/playwright-core/src/protocol/validator.ts b/packages/playwright-core/src/protocol/validator.tsindex 5fe1cce5d2..2e037ab2b5 100644--- a/packages/playwright-core/src/protocol/validator.ts+++ b/packages/playwright-core/src/protocol/validator.ts@@ -1296,6 +1296,7 @@ scheme.FrameCheckParams = tObject({selector: tString,strict: tOptional(tBoolean),force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),position: tOptional(tType('Point')),timeout: tFloat,trial: tOptional(tBoolean),@@ -1305,6 +1306,7 @@ scheme.FrameClickParams = tObject({selector: tString,strict: tOptional(tBoolean),force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),noWaitAfter: tOptional(tBoolean),modifiers: tOptional(tArray(tEnum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift']))),position: tOptional(tType('Point')),@@ -1324,6 +1326,7 @@ scheme.FrameDragAndDropParams = tObject({source: tString,target: tString,force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),timeout: tFloat,trial: tOptional(tBoolean),sourcePosition: tOptional(tType('Point')),@@ -1354,6 +1357,7 @@ scheme.FrameDblclickParams = tObject({selector: tString,strict: tOptional(tBoolean),force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),modifiers: tOptional(tArray(tEnum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift']))),position: tOptional(tType('Point')),delay: tOptional(tFloat),@@ -1442,6 +1446,7 @@ scheme.FrameHoverParams = tObject({selector: tString,strict: tOptional(tBoolean),force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),modifiers: tOptional(tArray(tEnum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift']))),position: tOptional(tType('Point')),timeout: tFloat,@@ -1587,6 +1592,7 @@ scheme.FrameTapParams = tObject({selector: tString,strict: tOptional(tBoolean),force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),modifiers: tOptional(tArray(tEnum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift']))),position: tOptional(tType('Point')),timeout: tFloat,@@ -1617,6 +1623,7 @@ scheme.FrameUncheckParams = tObject({selector: tString,strict: tOptional(tBoolean),force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),position: tOptional(tType('Point')),timeout: tFloat,trial: tOptional(tBoolean),@@ -1751,6 +1758,7 @@ scheme.ElementHandleBoundingBoxResult = tObject({});scheme.ElementHandleCheckParams = tObject({force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),position: tOptional(tType('Point')),timeout: tFloat,trial: tOptional(tBoolean),@@ -1758,6 +1766,7 @@ scheme.ElementHandleCheckParams = tObject({scheme.ElementHandleCheckResult = tOptional(tObject({}));scheme.ElementHandleClickParams = tObject({force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),noWaitAfter: tOptional(tBoolean),modifiers: tOptional(tArray(tEnum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift']))),position: tOptional(tType('Point')),@@ -1775,6 +1784,7 @@ scheme.ElementHandleContentFrameResult = tObject({});scheme.ElementHandleDblclickParams = tObject({force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),modifiers: tOptional(tArray(tEnum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift']))),position: tOptional(tType('Point')),delay: tOptional(tFloat),@@ -1805,6 +1815,7 @@ scheme.ElementHandleGetAttributeResult = tObject({});scheme.ElementHandleHoverParams = tObject({force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),modifiers: tOptional(tArray(tEnum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift']))),position: tOptional(tType('Point')),timeout: tFloat,@@ -1927,6 +1938,7 @@ scheme.ElementHandleSetInputFilesParams = tObject({scheme.ElementHandleSetInputFilesResult = tOptional(tObject({}));scheme.ElementHandleTapParams = tObject({force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),modifiers: tOptional(tArray(tEnum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift']))),position: tOptional(tType('Point')),timeout: tFloat,@@ -1945,6 +1957,7 @@ scheme.ElementHandleTypeParams = tObject({scheme.ElementHandleTypeResult = tOptional(tObject({}));scheme.ElementHandleUncheckParams = tObject({force: tOptional(tBoolean),+ scroll: tOptional(tEnum(['auto', 'none'])),position: tOptional(tType('Point')),timeout: tFloat,trial: tOptional(tBoolean),diff --git a/packages/playwright-core/src/server/channels.d.ts b/packages/playwright-core/src/server/channels.d.tsindex e8c7c0ddc8..153920cac6 100644--- a/packages/playwright-core/src/server/channels.d.ts+++ b/packages/playwright-core/src/server/channels.d.ts@@ -2465,6 +2465,7 @@ export type FrameCheckParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,timeout: number,trial?: boolean,@@ -2472,6 +2473,7 @@ export type FrameCheckParams = {export type FrameCheckOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,trial?: boolean,};@@ -2480,6 +2482,7 @@ export type FrameClickParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',noWaitAfter?: boolean,modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,@@ -2493,6 +2496,7 @@ export type FrameClickParams = {export type FrameClickOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',noWaitAfter?: boolean,modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,@@ -2512,6 +2516,7 @@ export type FrameDragAndDropParams = {source: string,target: string,force?: boolean,+ scroll?: 'auto' | 'none',timeout: number,trial?: boolean,sourcePosition?: Point,@@ -2521,6 +2526,7 @@ export type FrameDragAndDropParams = {};export type FrameDragAndDropOptions = {force?: boolean,+ scroll?: 'auto' | 'none',trial?: boolean,sourcePosition?: Point,targetPosition?: Point,@@ -2565,6 +2571,7 @@ export type FrameDblclickParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,delay?: number,@@ -2576,6 +2583,7 @@ export type FrameDblclickParams = {export type FrameDblclickOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,delay?: number,@@ -2696,6 +2704,7 @@ export type FrameHoverParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,timeout: number,@@ -2704,6 +2713,7 @@ export type FrameHoverParams = {export type FrameHoverOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,trial?: boolean,@@ -2915,6 +2925,7 @@ export type FrameTapParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,timeout: number,@@ -2923,6 +2934,7 @@ export type FrameTapParams = {export type FrameTapOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,trial?: boolean,@@ -2960,6 +2972,7 @@ export type FrameUncheckParams = {selector: string,strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,timeout: number,trial?: boolean,@@ -2967,6 +2980,7 @@ export type FrameUncheckParams = {export type FrameUncheckOptions = {strict?: boolean,force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,trial?: boolean,};@@ -3194,18 +3208,21 @@ export type ElementHandleBoundingBoxResult = {};export type ElementHandleCheckParams = {force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,timeout: number,trial?: boolean,};export type ElementHandleCheckOptions = {force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,trial?: boolean,};export type ElementHandleCheckResult = void;export type ElementHandleClickParams = {force?: boolean,+ scroll?: 'auto' | 'none',noWaitAfter?: boolean,modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,@@ -3218,6 +3235,7 @@ export type ElementHandleClickParams = {};export type ElementHandleClickOptions = {force?: boolean,+ scroll?: 'auto' | 'none',noWaitAfter?: boolean,modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,@@ -3235,6 +3253,7 @@ export type ElementHandleContentFrameResult = {};export type ElementHandleDblclickParams = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,delay?: number,@@ -3245,6 +3264,7 @@ export type ElementHandleDblclickParams = {};export type ElementHandleDblclickOptions = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,delay?: number,@@ -3284,6 +3304,7 @@ export type ElementHandleGetAttributeResult = {};export type ElementHandleHoverParams = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,timeout: number,@@ -3291,6 +3312,7 @@ export type ElementHandleHoverParams = {};export type ElementHandleHoverOptions = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,trial?: boolean,@@ -3473,6 +3495,7 @@ export type ElementHandleSetInputFilesOptions = {export type ElementHandleSetInputFilesResult = void;export type ElementHandleTapParams = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,timeout: number,@@ -3480,6 +3503,7 @@ export type ElementHandleTapParams = {};export type ElementHandleTapOptions = {force?: boolean,+ scroll?: 'auto' | 'none',modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[],position?: Point,trial?: boolean,@@ -3501,12 +3525,14 @@ export type ElementHandleTypeOptions = {export type ElementHandleTypeResult = void;export type ElementHandleUncheckParams = {force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,timeout: number,trial?: boolean,};export type ElementHandleUncheckOptions = {force?: boolean,+ scroll?: 'auto' | 'none',position?: Point,trial?: boolean,};diff --git a/packages/playwright-core/src/server/dom.ts b/packages/playwright-core/src/server/dom.tsindex 872e294f1b..c58c902914 100644--- a/packages/playwright-core/src/server/dom.ts+++ b/packages/playwright-core/src/server/dom.ts@@ -404,9 +404,11 @@ export class ElementHandle<T extends Node = Node> extends js.JSHandle<T> {forceScrollOptions: ScrollIntoViewOptions | undefined,options: { waitAfter: boolean | 'disabled' } & types.PointerActionOptions & types.PointerActionWaitOptions,): Promise<PerformActionResult> {- const { force = false, position } = options;+ const { force = false, position, scroll } = options;- const doScrollIntoView = async (progress: Progress) => {+ const doScrollIntoView = async (progress: Progress): Promise<'error:notvisible' | 'error:notconnected' | 'done'> => {+ if (scroll === 'none')+ return 'done';if (forceScrollOptions) {return await progress.race(this.evaluateInUtility(([injected, node, options]) => {if (node.nodeType === 1 /* Node.ELEMENT_NODE */)diff --git a/packages/playwright-core/src/server/types.ts b/packages/playwright-core/src/server/types.tsindex 33efd23934..4c3fb2cf22 100644--- a/packages/playwright-core/src/server/types.ts+++ b/packages/playwright-core/src/server/types.ts@@ -38,6 +38,7 @@ export type NavigateOptions = {export type CommonActionOptions = StrictOptions & {force?: boolean,noAutoWaiting?: boolean,+ scroll?: 'auto' | 'none',};export type PointerActionWaitOptions = CommonActionOptions & {diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.tsindex 5f01196f87..b215084259 100644--- a/packages/playwright-core/types/types.d.ts+++ b/packages/playwright-core/types/types.d.ts@@ -2138,6 +2138,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -2245,6 +2253,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -2384,6 +2400,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -2503,6 +2527,14 @@ export interface Page {*/noWaitAfter?: boolean;+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Clicks on the source element at this point relative to the top-left corner of the element's padding box. If not* specified, some visible point of the element is used.@@ -3330,6 +3362,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -4313,6 +4353,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -4574,6 +4622,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -4722,6 +4778,14 @@ export interface Page {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -6243,6 +6307,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -6339,6 +6411,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -6435,6 +6515,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -6540,6 +6628,14 @@ export interface Frame {*/noWaitAfter?: boolean;+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Clicks on the source element at this point relative to the top-left corner of the element's padding box. If not* specified, some visible point of the element is used.@@ -7168,6 +7264,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -7702,6 +7806,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -7877,6 +7989,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -8025,6 +8145,14 @@ export interface Frame {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** When true, the call requires selector to resolve to a single element. If given selector resolves to more than one* element, the call throws an exception.@@ -11741,6 +11869,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -11825,6 +11961,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor* position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.@@ -11914,6 +12058,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor* position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.@@ -12088,6 +12240,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -12530,6 +12690,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -12658,6 +12826,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -12762,6 +12938,14 @@ export interface ElementHandle<T=Node> extends JSHandle<T> {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -13244,6 +13428,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -13389,6 +13581,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor* position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.@@ -13512,6 +13712,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor* position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.@@ -13662,6 +13870,14 @@ export interface Locator {*/noWaitAfter?: boolean;+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Clicks on the source element at this point relative to the top-left corner of the element's padding box. If not* specified, some visible point of the element is used.@@ -14354,6 +14570,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -15026,6 +15250,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -15182,6 +15414,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using the@@ -15304,6 +15544,14 @@ export interface Locator {y: number;};+ /**+ * Controls whether Playwright scrolls the element into view before performing the action. Defaults to `"auto"`, which+ * scrolls the element into view when necessary, including scrolling nested scrollable containers. When set to+ * `"none"`, Playwright does not scroll the element and the action fails if the element is not already in the+ * viewport. This is useful to assert that an element is reachable by the user without additional scrolling.+ */+ scroll?: "auto"|"none";+/*** Maximum time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `actionTimeout`* option in the config, or by using thediff --git a/packages/protocol/spec/frame.yml b/packages/protocol/spec/frame.ymlindex 2ff4909e77..ec1813aa96 100644--- a/packages/protocol/spec/frame.yml+++ b/packages/protocol/spec/frame.yml@@ -110,6 +110,11 @@ Frame:selector: stringstrict: boolean?force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - noneposition: Point?timeout: floattrial: boolean?@@ -126,6 +131,11 @@ Frame:selector: stringstrict: boolean?force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - nonenoWaitAfter: boolean?modifiers:type: array?@@ -170,6 +180,11 @@ Frame:source: stringtarget: stringforce: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - nonetimeout: floattrial: boolean?sourcePosition: Point?@@ -225,6 +240,11 @@ Frame:selector: stringstrict: boolean?force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - nonemodifiers:type: array?items:@@ -374,6 +394,11 @@ Frame:selector: stringstrict: boolean?force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - nonemodifiers:type: array?items:@@ -634,6 +659,11 @@ Frame:selector: stringstrict: boolean?force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - nonemodifiers:type: array?items:@@ -694,6 +724,11 @@ Frame:selector: stringstrict: boolean?force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - noneposition: Point?timeout: floattrial: boolean?diff --git a/packages/protocol/spec/handles.yml b/packages/protocol/spec/handles.ymlindex edab0387c6..54440f7018 100644--- a/packages/protocol/spec/handles.yml+++ b/packages/protocol/spec/handles.yml@@ -125,6 +125,11 @@ ElementHandle:title: Checkparameters:force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - noneposition: Point?timeout: floattrial: boolean?@@ -139,6 +144,11 @@ ElementHandle:title: Clickparameters:force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - nonenoWaitAfter: boolean?modifiers:type: array?@@ -179,6 +189,11 @@ ElementHandle:title: Double clickparameters:force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - nonemodifiers:type: array?items:@@ -252,6 +267,11 @@ ElementHandle:title: Hoverparameters:force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - nonemodifiers:type: array?items:@@ -490,6 +510,11 @@ ElementHandle:title: Tapparameters:force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - nonemodifiers:type: array?items:@@ -536,6 +561,11 @@ ElementHandle:title: Uncheckparameters:force: boolean?+ scroll:+ type: enum?+ literals:+ - auto+ - noneposition: Point?timeout: floattrial: boolean?diff --git a/tests/page/page-click-scroll.spec.ts b/tests/page/page-click-scroll.spec.tsindex f8c9c1f976..e1c0f80c3b 100644--- a/tests/page/page-click-scroll.spec.ts+++ b/tests/page/page-click-scroll.spec.ts@@ -104,3 +104,55 @@ it('should scroll into view element in iframe', async ({ page, isAndroid, server`);await page.frameLocator('iframe').getByRole('button').click({ timeout: 5000 });});++it('should not scroll the page when scroll is "none"', async ({ page }) => {+ it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/41421' });+ await page.setContent(`+ <div style="height: 2000px;"></div>+ <button onclick="window._clicked=true">click me</button>+ `);+ const error = await page.locator('button').click({ scroll: 'none', timeout: 2000 }).catch(e => e);+ expect(error.message).toContain('element is outside of the viewport');+ expect(await page.evaluate('window._clicked')).toBeFalsy();+ expect(await page.evaluate(() => window.scrollY)).toBe(0);+});++it('should click in-viewport element when scroll is "none"', async ({ page }) => {+ await page.setContent(`+ <button onclick="window._clicked=true">click me</button>+ <div style="height: 2000px;"></div>+ `);+ await page.locator('button').click({ scroll: 'none', timeout: 2000 });+ expect(await page.evaluate('window._clicked')).toBe(true);+ expect(await page.evaluate(() => window.scrollY)).toBe(0);+});++it('should not scroll nested container when scroll is "none"', async ({ page }) => {+ it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/41421' });+ await page.setContent(`+ <div style="height: 100px; width: 100px; overflow-y: scroll;">+ <div style="height: 50px;">A</div>+ <div style="height: 50px;">B</div>+ <button style="height: 50px; width: 100px;" onclick="window._clicked=true">C</button>+ </div>+ `);+ const button = page.locator('button');+ // The button is scrolled out of the nested overflow container.+ const error = await button.click({ scroll: 'none', timeout: 2000 }).catch(e => e);+ expect(error).toBeTruthy();+ expect(await page.evaluate('window._clicked')).toBeFalsy();+ // Default behavior scrolls the nested container into view and succeeds.+ await button.click({ timeout: 2000 });+ expect(await page.evaluate('window._clicked')).toBe(true);+});++it('should not scroll on hover when scroll is "none"', async ({ page }) => {+ await page.setContent(`+ <div style="height: 2000px;"></div>+ <div onmouseover="window._hovered=true" style="width: 50px; height: 50px;">hover me</div>+ `);+ const error = await page.locator('div >> text=hover me').hover({ scroll: 'none', timeout: 2000 }).catch(e => e);+ expect(error.message).toContain('element is outside of the viewport');+ expect(await page.evaluate('window._hovered')).toBeFalsy();+ expect(await page.evaluate(() => window.scrollY)).toBe(0);+});