SDET Unicorns

WebdriverIO – Wait Commands Example

Table of Content

If you have had some experience with Automated testing, I’m sure you’ve had to deal with flaky/unstable tests. Some of these unstable tests can be fixed by utilizing the right wait commands, let’s take a look at a couple of examples below…

1. waitForDisplayed

waitForDisplayed is one of the most commonly used wait commands, it waits for an element to be displayed or not be displayed on the screen for ‘X’ amount of milliseconds.

Scenario: Wait for ‘Watches’ link to be displayed after hovering over the ‘Fashion’ link on the eBay site. (see gif below)


Note: I’m using Page Object Model in my example below. To learn more about POM you can take a look at my video here

it('should click on watches link', () => {
  // open the ebay site;

  // hover over the fashion link

  // wait for max 5 secs for watches link to be displayed after hovering over the fashion link
  WatchesPage.watchesLink.waitForDisplayed({ timeout: 5000 });

  // once displayed, click on the watches link;

2. waitUntil

waitUntil is used to wait conditionally, once the condition fulfills, it moves on to the next action.

Scenario: Wait for ‘All Categories’ text in the drop-down to change to “PC laptops & Notebooks” text after searching for the ‘Laptop’ keyword on the eBay site. (see gif below)

it('should update the search category', () => {
    function () {
      // get text for the search category selector
      // and check if it matches the expected text
      return SearchPage.category.getText() === 'PC Laptops & Netbooks';
    // wait for 3 seconds for condition to fulfill
    { timeout: 3000 }
  // add your assertion
  expect(SearchPage.category).toHaveText('PC Laptops & Netbooks');

Similarly, you can use other wait commands provided by WebdriverIO for different scenarios such as waitForClickablewaitForDisplayed etc.. You can find all the commands in their API docs.

? This code is also available on GitHub for you to access and play around with.

You can also checkout the video below that will show you the detailed explanation of the code above.

To learn more about WebdriverIO, you can check out my free tutorial series here –

WebdriverIO – Tutorial Series for Beginners

My Resources

Thrive Suite: The all-in-one WordPress theme I used to create my blog.
Jasper AI: My favorite AI writing tool.
Surfer SEO:  A tool to help you rank your content on the first page of Google.

Write Content Faster


Write blog posts that rank for affiliate terms!

Join our mailing list

Unlock the Secrets to Becoming a SDET Pro in the Industry!

Stay ahead of the curve! Join our mailing list for exclusive insights, tips, and the latest industry updates delivered straight to your inbox

Table of Content

Related Post

7 Principles of Software Testing

7 Principles of Software Testing with Examples

Software testing plays a crucial role in the software development life cycle as it helps ensure the quality, reliability, and performance of the final product. Software testing is not just about finding defects; it also provides valuable insights into the overall quality of the software. By conducting effective software testing, it shows how well the application behaves in different scenarios and whether it meets user expectations.

Read More »
Differences Between CI/CD and DevOps

Key Differences Between CI/CD and DevOps

Software development is far from a simple journey that involves merely executing code and launching applications. It often presents challenges, as it’s rare to get everything right from the start. Each time you implement new or frequent code changes, you inadvertently introduce potential issues that can be time-consuming to resolve. This complexity necessitates a structured approach to ensure smooth production.

Read More »