Selenium Hacks for Beginners
By Wilhelm Haaker
October 15, 2019
7 min read
If you're looking for a Selenium cheat sheet to get you going with Selenium web testing, here's an experience-packed breakdown of how to get started with Selenium.
Jump to Section
During my Selenium learning experience, I discovered some tips and tricks to get started. Here are some great resources that could help you, too.
I recently learned how to use Selenium, because of Parasoft’s new product for Selenium testers, Parasoft Selenic. I did already have some experience with web testing, writing Java code, and JUnit, but I had never used Selenium before. Here are some useful resources I found helpful in ramping up.
What Is Selenium?
The first thing is to make sure you understand the difference between Selenium IDE and Selenium WebDriver. I had thought that Selenium IDE, a GUI record/playback program built on top of Selenium WebDriver, would be a great way to get started, but I quickly found myself running into limitations where playback was unsuccessful with bad/missing locators, and realized that any serious Selenium tester is writing code using the Selenium WebDriver. The die was cast, I had to start writing code.
Getting Started With the Selenium WebDriver
The Selenium WebDriver libraries are available for several different languages, making Selenium accessible to a wide audience of people. Since I’m most comfortable writing code in Java, I stuck with that. (Also, while JUnit is not required for Selenium testing in Java, I don’t see why anyone wouldn’t use it, as it comes with a bunch of features specifically geared for writing test cases in Java.)
Lastly, if I was going to be writing JUnits, then I figured I might as well be writing them in an IDE. There are two IDEs that are mostly used in the industry for Java: Eclipse, and IntelliJ. Most of my career has been with using Eclipse, so I stuck with that.
Having made these decisions, I was ready to get started.
Skills to Know for Selenium
Before you get going, make sure you have some prerequisite skills, to get going with test automation basics.
Familiarity with HTML and CSS: You shouldn’t be afraid of a website’s page source and you should understand how the page source translates to what you see rendered in the browser. If HTML is totally foreign to you, then I suggest some foundational education. Here is a great website that helped me in my early education to the web:
Browser’s Developer Tools & XPath: Another foundational skill is understanding how to locate elements on a page. Selenium WebDriver supports several mechanisms for doing this, of which you’ll soon get exposed to. You’ll want to be comfortable using the browser’s developer tools to locate elements on a page, and here’s a great tutorial to bring you up to speed with Chrome:
If you’re looking to transition into a test automation engineering role, then you’ll need to develop some coding skills. Before you freak out, the good news is that writing code to automate web testing in Selenium is relatively easy. In fact, I think Selenium is a great way to learn coding; the code you’ll be writing is narrowly constrained so you’re less likely to get totally overwhelmed. It shouldn’t be hard finding free tutorials and lessons to get you started with whatever language you choose. For the purposes of learning what you need to know for Selenium, I found a fantastic tutorial that covers Java and Selenium for a total beginner:
If you do choose Java, then I recommend also learning JUnit, which is a popular testing framework for Java. Here’s a great tutorial that covers JUnit AND the final lesson covers applying JUnit with Selenium testing:
Setting Up Your Environment
Besides the Tutorial from toolsqa, another resource I found myself frequenting was this:
These two resources will cover all the topics necessary for you to set up your environment with Eclipse, Java, JUnit 4, Selenium WebDriver, and Maven.
…Maven? What’s that? One comment I’ll make is that most tutorials I found put Maven as an advanced topic further down the list. Maven is a build tool that makes compiling, testing, and deploying code easier to manage with all their required dependencies. Like JUnit, Maven is another optional item, but I want to bring it up now because it makes your project setup easier once you know what to do. If you start with Maven, then you won’t have to think about converting your Java Project to a Maven Project later, just start with Maven from the beginning! The tutorial I liked best for this was from:
Your First Selenium Script
Both of the tutorial references I mentioned do a good job walking you through creating your first script. The toolsqa article assumes less coding knowledge and the softwaretestinghelp.com link covers more ground, but they’re both excellent:
Once you’ve gotten your first script up and running, and you’re up to speed with JUnit, the final lesson from toolsqa’s JUnit tutorial will help you refactor your initial scripts to the JUnit format:
The Page Object Model in Selenium
After you’ve gotten comfortable with Selenium basics and you have a script that plays back a scenario or two in your browser, you should be ready to go to the next level. The Page Object Model is a way of organizing your Selenium test code to make it more maintainable and decrease duplicate code. My tests up until this point had all the test code contained within my test method. So I went through a 2-step process, first refactoring my existing test to Page Object Model, and then second refactoring again to optimize it with the Page Factory pattern. This was an instructive 2-step process and I can only imagine how much I’d be regretting it if I skipped these best practices and ran wild creating test after test. You can do this automatically if you are using the Smart Recorder in Parasoft Selenic. Here are a couple guides that I used to educate myself on the topic:
If this seems like extra work and extra code for the same result, you’d be right. And if you’re only ever going to have 1 or 2 tests, then maybe this is overkill but that’s never the case for a test automation engineer. This pattern ends up making all the sense in the world when you’re building a robust regression test suite of 100s or 1000s of tests. Code re-use is going to save you unbelievable amounts of time in the long run.
As you start experimenting with your Selenium scripts, you’ll start to appreciate why I listed locating elements on a page as a necessary skill. You’re going to find yourself in the browser’s developer tools extension A LOT, and you’re going to start experimenting with XPath. While there are many ways of locating elements on a page with Selenium, XPath is one of the most flexible and powerful. If you can’t uniquely identify an element with simple strategies like using an id, name, or link, then you’re looking at XPath or CSS Locators. Any reasonably complex Selenium test is going to need a little XPath here or there to locate stubborn page elements and the better you get with XPath the more effective of a tester you will become.
Alright Wilhelm, XPath is great, can you give me something more than homework here? Actually, yes! There’s also a nifty Chrome Extension (it’s also available for Firefox) called TruePath. This plugin does a decent job of coming up with lists of recommended XPaths to choose from that you can copy/paste into your Selenium locator code. It’s not always perfect, but I found it helpful in either presenting a Relative XPath I immediately liked, or presenting a Relative XPath that was close enough to something I liked and I could then use that as my starting point to tweak.
Smart Waiting On AJAX That Uses jQuery
For beginners, this extra information is great, but if you want something that’s more to the point, here’s a concise article on the same topic:
The last topic I’ll leave with you is one that plagues every Selenium tester, which is managing change. One of the drawbacks to web test automation is the frequency with which the UI changes and how that can impact the stability of your automated tests. As a test automation engineer, you’ll soon get uncomfortably used to the process of troubleshooting why a test failed to execute all the way through and whether that was:
- A problem with your test
- A problem with the environment
- An innocuous change to the application (i.e. not a bug)
- An unexpected change to the application (i.e. a real bug!)
Expect a lot of false alarms with your automated tests failing not because they found a bug, but rather because they need to be maintained or because the environment had an issue.
One of the strategies to help minimize this pervasive problem I’ve already touched on with Element Location. Often when a test fails to locate an Element, it’s because it is using a location strategy that is no longer valid on the newest deployment of the application. How you are locating an Element can matter here, so let’s discuss an example of how to write a locator that is resilient to change:
If you think about an absolute XPath to an Element like this:
Boy, any little change to the HTML is going to break that thing. If you construct a Relative XPath like this:
//p[@id=’8232:0′][contains(.,’Guidance for Success’)]
Then your test stands a better chance of succeeding. Note the words “better chance.” Sometimes the application will change so much that you’re simply out of luck. But writing more resilient tests will reduce the chance of future work for yourself. (Or you can check out Parasoft Selenic.)
This same issue is also present with waiting. Many factors can cause instability in your test automation because of wait conditions. Using strategies like Smart Waiting on AJAX Using jQuery will help you reduce the likelihood of needing to address a problem with your test because of wait conditions. While on the subject, here’s a helpful tutorial about waits in Selenium:
Just like with element location, though, sometimes you’re going to be S-O-L and maintenance is unavoidable.
The experience of learning Selenium has given me an appreciation for the challenges you can expect to face out there in your journey to become a test automation engineer. If you’re new and feeling intimidated, just remember that this is easier than you think, and you’ll be an expert automated web tester in no time.