Cypress web自动化30-操作窗口滚动条(scrollTo)

前言

web页面的操作，有些元素不在窗口上显示，需滑动滚动条才能显示出来，Cypress 可以使用 scrollTo 操作滚动条的位置。
可以根据窗口的位置来滚动，也可以根据屏幕像素或百分比来滚动。

相关语法

操作 window 窗口对象，窗口上的滚动条，可以直接使用cy.scrollTo()

cy.scrollTo(position)
cy.scrollTo(x, y)
cy.scrollTo(position, options)
cy.scrollTo(x, y, options)
// 正确用法示例
cy.scrollTo(0, 500)                     // Scroll the window 500px down

也可以先定位到元素，滚动到元素的位置

.scrollTo(position)
.scrollTo(x, y)
.scrollTo(position, options)
.scrollTo(x, y, options)
// 正确用法示例
cy.get('.sidebar').scrollTo('bottom')   // Scroll 'sidebar' to its bottom

参数说明：

• position(字符串) 窗口或元素滚动到的指定位置，有效的位置topLeft，top，topRight，left，center，right，bottomLeft，bottom，和bottomRight。
• x（数字，字符串） 距离窗口/元素左侧的距离（以像素为单位）或滚动到的窗口/元素宽度的百分比。
• y（数字，字符串） 与窗口/元素顶部之间的距离（以像素为单位）或滚动到的窗口/元素高度的百分比。
• options(对象) 可选项传递选项对象以更改的默认行为cy.scrollTo()。

options 选项参数说明

选项	默认	描述
log	true	在命令日志中显示命令
duration	0	滚动持续时间（以毫秒为单位）
easing	swing	将随着缓动动画滚动
timeout	defaultCommandTimeout	命令行默认超时时间 4000毫秒

position 窗口滚动到的指定位置

position 参数将窗口或元素滚动到的指定位置。窗口有效的位置topLeft，top，topRight，left，center，right，bottomLeft，bottom，和bottomRight

使用案例

/**
 * Created by dell on 2020/6/3.
 *  作者：上海-悠悠 交流QQ群:939110556
 */

describe('web滚动窗口案例', function() {
    beforeEach(() => {
          cy.visit('https://www.cnblogs.com/yoyoketang/')

        })

    it("上下拖动", () =>
    {
        // 滚动到窗口底部
        cy.scrollTo('bottom')
        cy.wait(3000)
        // 左下角
        cy.scrollTo('bottomLeft')
        cy.wait(3000)
        // 回到顶部
        cy.scrollTo('top')

    })
    })

x 横向左右滚动

x 参数控制横向左右滚动，x参数可以是数字，也可以是字符串，也可以是百分比

        // x 横向，距离左侧100像素，可以是数字100
        cy.scrollTo('100')
        cy.wait(3000)
        // x 横向，距离左侧150像素，可以是字符串150
        cy.scrollTo('150')
        // x 200像素
        cy.wait(3000)
        cy.scrollTo('200px')
        // 按百分比，滚动50%，也就是正中间
        cy.wait(3000)
        cy.scrollTo('50%')

y 纵向上下滚动

y 参数控制纵向上下滚动，y参数可以是数字，也可以是字符串，也可以是百分比

        // y 纵向 上下滚动，往下滚动100像素
        cy.scrollTo(0, 100)
        // 也可以传字符串
        cy.wait(3000)
        cy.scrollTo('0', '200')
        // 滚动到中间位置 50%
        cy.wait(3000)
        cy.scrollTo('0', '50%')

duration 持续滚动

有些web页面可以一直拖到底部，到底部后又会刷新出新的页面来，如果我想持续滚动3秒，可以加 duration 持续时间

/**
 * Created by dell on 2020/6/3.
 *  作者：上海-悠悠 交流QQ群:939110556
 */

describe('web滚动窗口案例', function() {
    beforeEach(() => {
          cy.visit('https://www.jd.com/')

        })

    it("滚动窗口,持续拖动底部", () =>
    {
        cy.scrollTo('bottom', { duration: 3000 })
    })
    })

但是当duration持续时间大于4秒时会发生一个报错 ：Cypress command timeout of 4000ms exceeded.

cy.scrollTo('bottom', { duration: 6000 })

由于 defaultCommandTimeout 默认超时时间是4000 毫秒，需在 cypress.json配置下，把时间改大一点

{
"defaultCommandTimeout": 30000
}

如果你想在运行结果查看滚动效果，cypress 无法反映快照中任何元素的准确滚动位置,只能自己加wait等待时间查看效果，或者用 .pause() 暂停