[pull] main from microsoft:main

.github/workflows/publish_release.yml

@@ -7,8 +7,10 @@ on:
   push:
     branches:
       - release-*
-  release:
-    types: [published]
+    tags:
+      # TODO: revert this to "published release" once github.ref is set there.
+      # See https://github.com/actions/runner/issues/2788 as well.
+      - 'v1.61.1'
 
 jobs:
   publish-npm-and-driver:
@@ -47,7 +49,7 @@ jobs:
         node utils/build/update_canary_version.js --beta --commit-timestamp
         utils/publish_all_packages.sh --beta
     - name: "publish release to NPM"
-      if: github.event_name == 'release' && github.event.action == 'published'
+      if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
       run: utils/publish_all_packages.sh --release
 
     - name: Azure Login
@@ -58,7 +60,7 @@ jobs:
         subscription-id: ${{ secrets.AZURE_PW_CDN_SUBSCRIPTION_ID }}
     - name: build & publish driver
       env:
-        AZ_UPLOAD_FOLDER: ${{ github.event_name == 'release' && 'driver' || 'driver/next' }}
+        AZ_UPLOAD_FOLDER: ${{ startsWith(github.ref, 'refs/tags/v') && 'driver' || 'driver/next' }}
       run: |
         utils/build/build-playwright-driver.sh
         utils/build/upload-playwright-driver.sh
@@ -89,7 +91,7 @@ jobs:
       env:
         GH_SERVICE_ACCOUNT_TOKEN: ${{ steps.app-token.outputs.token }}
     - name: Deploy Stable
-      if: github.event_name == 'release' && github.event.action == 'published'
+      if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
       run: bash utils/build/deploy-trace-viewer.sh --stable
       env:
         GH_SERVICE_ACCOUNT_TOKEN: ${{ steps.app-token.outputs.token }}

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.8
 

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.8
 

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.14
 

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.8
 

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]>