How to Scroll Web Pages Using TestCafe

If you're writing functional tests, you may need to scroll tested pages to display specific elements. In this article, we look at several test scenarios to show how TestCafe navigates pages.

Built-in TestCafe Actions Scroll the Page Automatically

Each TestCafe API action scrolls a page to show the target element. You don't need to write extra code to click a button or input text. Simply pass a selector to the action method. TestCafe will automatically scroll to the element and execute the action.

// scroll to the "#submit-btn" element and click it

Scroll to a Rendered DOM Element

If you need to scroll a page to display a specific element or area, but don't need to perform an action on the target element, use the hover method.

// scroll to the "#country-map" element
await t.hover('#country-map');

Scroll to a Dynamically Generated Element

In certain scenarios, elements cannot be identified by a selector. For instance, a page may contain a dynamically generated list of identical items. Another example is virtual scrolling: the element might not exist on a page when the action starts.

A solution in these cases is to use the browser's native API. For example, you can use the window.scrollBy method. To access this method, utilize the ClientFunction generator. Calculate the offset between the element and the top of the container, and pass these values to the scrollBy method.

import { ClientFunction } from 'testcafe';

fixture `Fixture`
   .page ``;

const scrollBy = ClientFunction((x, y) => {
   window.scrollBy(x, y);

test(`test`, async t => {
   const targetElementPosition = // ...

   await scrollBy(0, targetElementPosition);

   await t.debug();

Sometimes offset calculation is not an option. If a page uses virtual scrolling, element heights can change. You may not even know the number of elements above the element to be displayed. You might only know the element's content, such as its display text.

To find an element by text, scroll to the last rendered item on the list so that the next portion of elements are loaded. Continue the process until you locate the element. A selector's exists property allows you to scan rendered elements and see if an element with that text exists. If it does exist, the search is over. If not, repeat the cycle.

import { Selector } from 'testcafe';

fixture `Getting Started`

test('Test 1', async t => {
    const container  = Selector('._1oXCrgdVudv-QMFo7eQCLb');
    const listItem   = Selector('._113CIjCFcgg_BK6pEtLzCZ');
    const targetItem = listItem.withExactText('Tisha Wurster');


    while (!await targetItem.exists) {
        const bottomItemIndex = await listItem.count -1;
        const bottomItemText  = await listItem.nth(bottomItemIndex).textContent;
        const bottomItem      = await listItem.withExactText(bottomItemText);

        await t.hover(bottomItem);

    await t

    await t.debug();

We hope you find these tips useful.

Want to learn more about TestCafe? Feel free to mention @DXTestCafe on Twitter and suggest a topic for the next post.