Selenium Tutorial

Why is it important to have proper synchronization for your automated tests?

Have you ever dealt with flaky automated checks? Checks that fail intermittently and you are unsure why? How about checks that fail in your Continuous Integration environment, but work locally?

All of these could be a result of improper synchronization within your tests. Synchronization refers to the idea that the speed of your automated check should coincide with the speed of the application under test (AUT). Basically, if the code of your automated check runs faster or slower than the actual AUT, you will experience all of the problems that I listed above.

If your code runs too fast, it will not find HTML elements on a page that you were expecting to be there. If your code runs too slow, you will be wasting valuable time during test execution. Either way, this destroys the reputation of your functional checks and deems them as “flaky” or “slow”. No automated check of yours should wear those scarlet letters.

Therefore, proper synchronization techniques with automated functional GUI tests are extremely important for any Test Automation Engineer to know. This tutorial will take a very deep look at all of the timeouts and synchronization options available to you with Selenium Webdriver.

Pre-requisites


I am making the assumption that you have or know the following:

  1. Some flavor of Visual Studio installed

    -Although I will teach using C#, most of the concepts and ideas here can be applied to other bindings like Java, Ruby, and so on.

  2. General knowledge of C#
  3. Basic understanding of Selenium Webdriver
  4. Understanding of element locators using HTML

What Application Will we Test?


This is the AUT that we will be working with today. A Selenium guru by the name of Dave Haeffner uses this application to teach Selenium Webdriver. The goal of the test is really simple:

  1. Navigate to the page
  2. Click button with id = “start”
  3. Make sure that element with id = “finish” is present on the page

Improper Synchronization Example


I wrote a quick test to give you an example of what can happen when your synchronization strategy isn’t up to par. Take a look at this code:
If you try to run the test in your Visual Studio, you will probably receive a similar message like in the image below.

selenium

So why did this test fail? Take a moment to think about it and walk through the application or step through the code.

The automated check failed because of improper synchronization. After pressing the “start button”, there is a loading screen that we must wait for 5 seconds. However, in our automated check, we don’t have such a synchronization point. Therefore, when our test executes the line of code below, the Webdriver API comes back within 500ms and says that this element is not visible. Of course, it’s not visible, there is a stupid loading icon that we didn’t account for:

To resolve synchronization problems, I will teach you 3 types of techniques to apply to your tests.

What is an IMPLICIT Wait in Selenium Webdriver?


An implicit wait in Selenium came from Watir’s implicit wait idea. Here we are telling the Webdriver to poll the DOM for a specific amount of time when trying to find an element or elements. The default setting is 0 seconds. Once set, the timeout is set for the life of the driver, until it is changed again.

(Selenium HQ)

How do you use an Implicit Wait?

Once you create a type of driver, you will have access to the ImplicitlyWait() method. This method takes a TimeSpan object which you can use to specify the maximum of time that you want the driver to wait before throwing a NoSuchElementException.

What are the Advantages and Disadvantages of Implicit Waits?

Advantages

  • It’s really easy and quick to create these type of synchronizations

Disadvantages

  • The timeout lasts for the life of the driver. There are instances where you want your automated checks to fail right away when they cannot find an element. Therefore, you will need to reset the wait during that time and remember to set it back to the original value after you are done because the rest of the tests will now use the new value
  • Tests can be flakier or run longer as a result
What Exception is Thrown by an Implicit Wait?

OpenQA.Selenium.NoSuchElementException

What is an EXPLICIT Wait in Selenium Webdriver?


An explicit wait is code you define to wait for a certain condition to occur before proceeding further in the code. The worst case of this is Thread.Sleep(), which sets the condition to an exact time period to wait. There are some convenience methods provided that help you write code that will wait only as long as required. WebDriverWait in combination with ExpectedCondition is one way this can be accomplished. (Selenium HQ)

How do you use an Explicit Wait?

ExpectedConditions

These are a set of common conditions that can be used with the WebDriverWait class to check on the state of an object.

Some of the most common ones include:

Name Description
ElementExists An expectation for checking that an element is present on the DOM of a page. This does not necessarily mean that the element is visible.
ElementIsVisible An expectation for checking that an element is present on the DOM of a page and visible. Visibility means that the element is not only displayed but also has a height and width that is greater than 0.
FrameToBeAvailableAndSwitchToIt(String) An expectation for checking whether the given frame is available to switch to. If the frame is available it switches the given driver to the specified frame.
TextToBePresentInElement An expectation for checking if the given text is present in the specified element.
UrlContains An expectation for the URL of the current page to be a specific URL.

A full list of all the ExpectedConditions can be found here.

What are the Advantages and Disadvantages of Explicit Waits?

Advantages

  • The explicit wait is dynamic and great for locating elements in between transition points. It will wait the maximum amount of time specified, but only if necessary
  • Selenium Webdriver provides built in ExpectedConditions class out of the box so that we can check our web applications for different conditions with 1 or 2 lines of code

Disadvantages

  • A larger barrier to entry exists as compared to implicit waits because we need to learn all the different ways that we can apply an explicit wait
  • If using Thread.Sleep(), this can make our functional tests really brittle and slow

What Exception is Thrown by an Explicit Wait?

OpenQA.Selenium.NoSuchElementException

Don’t mix Your Implicit and Explicit Waits


A word of caution is to make sure that you do not mix implicit and explicit waits. The main problem is that implicit waits may be baked into the different components that are utilized by Selenium Webdriver, all the executables like ChromeDriver.exe, IEDriverServer.exe and so on. Therefore, when you are making multiple hops between the different implicit waits, you can stray into “undefined behavior” (Jim Evans).

I strongly recommend that you just use the Explicit Waits.

This post does a good job of conveying the undefined behavior when mixing waits.

DefaultWait


A Default Wait, also known as a Fluent Wait in Java is a type of wait that utilizes the DefaultWait class of the C# Webdriver bindings to set the synchronization timeouts. In Java, the WebDriverWait class inherits from the FluentWait class. However, in C#, the WebDriverWait class inherits from the DefaultWait class. Hence, the difference in nomenclature. Remember, the WebDriverWait class is the one that we use to construct our sexy explicit waits. Take a look at this snippet:

How do you use a DefaultWait?

The DefaultWait class exposes all of the functionality to us to construct really controlled synchronization points. For example, we can set the polling interval, the exceptions to ignore, and even write our own custom message.

What are the Advantages and Disadvantages of DefaultWaits?

Advantages

  • Provides us a really fine tuned way of controlling everything about a Selenium Webdriver wait

Disadvantages

  • You need to define your own Expected Conditions to be able to use these functions
  • Too much code required to create a simple synchronization point
  • Most of the functionality is already exposed through the 2 constructors that the WebDriverWait has

Conclusions

I created the table below to help you easily understand the difference between the three synchronization techniques that you can use to improve your test.

Type of wait Definition Usage Default Timeout(sec)
Implicit Tell Webdriver to poll the DOM for a certain amount of time https://gist.github.com/nadvolod/92aa44d6b1516cb65d7def7af2429726 0
Explicit Waits This is the code that you write to wait for a certain condition to occur before proceeding https://gist.github.com/nadvolod/b3a4f1c44f229a18037d48290df4994e .5
Default Waits This class allows you to specify the polling interval, the message, exceptions to ignore and much more. https://gist.github.com/nadvolod/9249cd30ac71065da2d20242f3683ac0 Depends on your implementation

The Selenium community recommends that you use Explicit Waits above all others because they provide the most benefit to your tests. However, using something like Thread.Sleep() is almost never acceptable. In my career, I have had only a handful of instances where I hardcoded my wait time. Rather, you should utilize WebDriverWait and ExpectedConditions for your explicit waits.

The DefaultWaits are nice to know, just to keep it in your back pocket. However, I have never had the need to use them. In fact, the most time that I spent with them was for this tutorial. In my opinion, the WebDriverWait class does an excellent job of exposing all of the relevant functionality to me without having to move up to the DefaultWait class. However, this does not mean that it won’t work for you.

Maybe you will find some awesome use for this class. If you do, let me know, I would love to learn how you use this class.

Finally, don’t forget that the entire goal of this tutorial is to make your automated checks more stable to deliver higher value to your employer. So, go and make your checks better. Until next time automation enthusiasts!

As you continue to learn more skills and concepts, do take a look at our Simple Programmer course: 10 Steps to Learn Anything Quickly.

Extra Resources