Automated Cross Browser Testing With Protractor & Selenium

Posted by Muthuraja | January 22, 2019
Automation • Cross Browser Testing • Selenium Tutorial •

12166 Views | 13 Min Read

Protractor

We are living in an era where numerous test automation tools or libraries are available in the market. The abundance brings along confusion and choosing the right framework turns out to be very challenging. Identifying the right tool at the earliest is crucial to for greater ROI. When come to Angular JS based application we don’t have to worry too much because we have Protractor in place. Google strongly recommends Protractor for end-to-end automation for AngularJS because both are maintained and owned by Google, and they build JavaScript test automation framework to handle AngularJS component in a better manner. In this article, we will be looking into details about what do we mean by JavaScript test automation Framework? What is Protractor? Why Protractor Is a good fit for test automation? How it helps to achieve cross browser test automation with different browsers?

What Do We Mean By JavaScript Test Automation Frameworks?

There has been major growth in JavaScript Framework usage over the past few years, the reason is, nowadays most of the apps are developed using technology like Angular JS or React JS. In fact, initially, AngularJS was the first choice for web developers, however, by the end of 2018, we could see major dominance over the web for ReactJS. ReactJS may even continue to dominate 2019 as well. To deal with these in test automation, we should adopt right programming language and test automation framework.

JavaScript test automation frameworks are end-to-end framework is specialized to run automation scripts for web application. However, choosing the right could be very challenging based on the following criteria selection.

Why JavaScript Framework Is Necessary When Compare With Other Languages?

JavaScript is no news to web developers. Most of the developers in an organization write JavaScript code for developing web applications, unit test etc. Here are the following reasons for considering JavaScript framework pivotal.

  • Easy to follow Shift left testing for better product quality.
  • Provides developers the flexibility of generating end to end tests, along with unit testing for faster and reliable shipping.
  • More collaboration between Dev and QA in same language for test automation.
  • Helps to implement Dev QA test and pair programming in test automation side.
  • More flexible to work all in same languages and better productivity.
  • Right tools and right approach in same languages gets greater benefits.

What Is Protractor?

Protractor is a JavaScript framework, end-to-end test automation framework for Angular and AngularJS application. It test against your application in real browser, like a real user would.

Protractor is built on top of WebDriver JS (Selenium) and apart from default locator, it comes up with Angular-specific locator strategies. It’s not intended to test only AngularJS application but also helps to write automation test for Non-Angular JS application.

What Makes Protractor A Good Fit For Your Automation Test Scripts?

Protractor is an open-source, End to End test automation framework, that is brought up by Google which makes it a reliable, renowned and up-to-date framework. Protractor is a Node.js program that supports testing framework like Jasmine, Mocha and Cucumber.

Key Features of Protractor:

  • Protractor is developed as a wrapper build around Selenium WebDriver JS and Selenium Server. All key feature of Selenium WebDriver JS and additional implementation helps to do better automation supports and less maintenance when compare with Selenium.
  • Protractor offers new locator strategies on top of native locator which actually helps to locate element in DOM easily.
    • by.model, by.binding, by.repeater etc.,
  • Protractor supports page object design pattern – helps on writing clean and readable code. Writing clean code is imperative for Automation testers. Here are 8 actionable insights for writing better automation code.
  • Protractor make use of Selenium Grid to initialize, control and run browser instance.
  • Can easily integrate with jasmine, mocha and cucumber framework to write your test.

Advantage of Protractor when combined with Selenium:

  • Excellent speed compare with other tools or libraries.
  • Support cross browser parallel testing through multiple browsers.
  • No need to work on synchronization strategy for eg., waits like implicit, explicits and sleep etc., Protractor has in build capabilities and intelligence to connect with Angular JS framework and knows when Angular has finished rendering the DOM for eg., page loading wait, synchronization,
  • Angular-specific locator support.

Getting Started With Cross Browser Automation Testing With Protractor and Selenium

Here are the prerequisite required for performing cross browser automation testing with Protractor and Selenium on Windows:

  • Node.js
  • Install protractor using npm
  • Update webdriver manager and start up a server
  • Visual Studio Code

Setting Up Automation Environment For Testing With Protractor And Selenium In Windows

This section has detailed steps explaining how to setup environment for performing end to end cross browser automation testing with Protractor and Selenium through Windows.

Step 1: Installation of Node.js

You need to install npm for Node.js.

What is npm?

npm is a free to use, package manager for javascript development which helps you to download all public software packages

What is package manager

A package in node.js contains group of files that you need for a module. Module is nothing it’s javascript libraries that can be included in your project.

To install Node.js, click here.
image-lambdatest

Once you are done downloading the installer, run it as administrator.

Click on ‘Next’ button in Node.js setup window to proceed further.

image-lambdatest

Click on checkbox for accepting license agreement and click on Next button.

image-lambdatest

Keep default windows location or feel free to change the location and click next.

image-lambdatest

Thereafter, click on Next and Install button. Wait for a couple minutes for the installation to complete.

You would have seen the following screen after installation completed.

image-lambdatest

To verify npm gets installed in your machine. Please supply the following command:

npm –version
image-lambdatest

Step 2: Installation of Protractor using npm

To download a package, open a command prompt and supply the following command

  • npm install –g protractor

install command is for download the package

-g stands for global which means any command to operate in global mode.

The below snapshot indicates that protractor is installed successfully.

image-lambdatest

To verify installed protractor version, supply the following command

  • protractor –version

image-lambdatest

Step 3: Update WebDriver Manager and Start Up A Server

To update webdriver manager, supply the following commands

  • webdriver-manager update

Once supply the above commands, it would download all necessary dependencies.

image-lambdatest

WebDriver manager is a helper tool to download necessary binaries. It will help to start and stop selenium server.

To start up with selenium server,

webdriver-manager start
image-lambdatest

To verify selenium server is running in browser, please use the following url

http://localhost:4444/wd/hub

Protractor test will send request to this server and control a local browser where you can see information about the status of the server. So, you could later go ahead and run your JS automation script with Protractor and Selenium.

Step 4: Installation of Visual Studio Code

What is Visual Studio Code?

Developed by Microsoft, Visual Studio code is a source code editor for Windows, Mac and Linux operating systems. It is a lot similar to other programming editor like Eclipse or Intellij. This tool was developed by Microsoft for Windows, Linux and Mac OS. It supports number of programming languages, to know more about Visual Studio code please visit here.

Double click on Visual Studio installer and click “Next” button.

image-lambdatest

Click on “I accept the agreement” in Setup – Visual Studio Code window

image-lambdatest

Keep default installation location (or) feel free to change different path in your computer and click “Next’ button.

image-lambdatest

Continue to click “Next” and check Desktop Shortcut if you want, finish the installation.

Once installation is complete, the following window would appear.

image-lambdatest

Click “Finish” button, finally Visual Studio Code Editors open up.

image-lambdatest

Click on the language which you want to install, I would suggest you to install JavaScript and TypeScript for executing automation test cases using Protractor and Selenium. Once clicked, it prompts you to select “ok” button, it would take few seconds to install the selected languages.

Writing Sample Code for Automation Testing With Protractor and Selenium

Now, we will have a look at a sample Javascript code for automation testing with Protractor and Selenium, and execute the test in local instance meaning execute the test that run on your browser installed in your machine.

To run protractor test for end to end automation, you must need two files:

  • Specs
  • Config

Specs: Specs is actual test suites that have more than on test cases designed in Javascript using Jasmine framework.


Download Whitepaper

What is Jasmine Framework?

Jasmine is a BDD(Behaviour Driven Deployment) testing framework for Javascript. This framework helps you to write clean and better readability of code. To know more about Jasmine Framework, please visit here.

Executing Single Instance For Automation Testing With Protractor and Selenium WebDriver(Local)

Here is the simple example config file and how to write basic code in Protractor using Jasmine Framework.

Config.js:


In the above snapshot shows the syntax of how to define config file to execute browser automation with Protractor and Selenium.

  • seleniumAddress: Protractor make use to Selenium Grid to run your test in specified browser.
  • specs: specs indicates test suite that you can mention in one or more spec files to run multiple tests.
  • Capabilities: This is the place where you can capability setting for your test configuration for eg., browser version, platform etc., in case no capabilities is provided then by default, it takes chrome browser in your machine.


We will see clear explanation of what is the above code indicating.

describe –> describe is the keyword from Jasmine to write syntax for test suites. This is definition of collection of test cases in your script file.

it –> is the keyword for test cases to meet specific condition. There can be more than one “it” added under describe in Jasmine framework.

In the above code, we launch the browser, navigate to sign up page, see the title gets matched and pass the results.

To run your test:

In Visual Studio Code: Go to View Menu-> Click “Terminal” and supply the following command

image-lambdatest

Syntax: To run your test suites protractor followed by config file name.

Note: Before run your test, please make to run selenium Grid by supply the following commands:

  • webdriver-manager start

image-lambdatest

After executing the above test, observed the following failures which is expected

image-lambdatest

The above screenshot indicates the website https://lambdatest.com is not developed using AngularJS component. This is best real time examples to realize how Protractor works while launching browser. As mentioned in “Advantages” topic in above, the Protractor basically tries to connect with Angular JS framework while launching application. The moment Protractor identified and realized it’s not an AngularJS component, it recommended us to turn off waiting for Angular.

To Address this problem: we have a method called “browser.waitForAngularEnabled(false);

Now, the method is added in the script and as you can see in the below screenshot, Protractor now supports with non-angular js application.


After executing the test, the test is passed successfully.

image-lambdatest

Executing Parallel Execution For Automation Testing With Protractor and Selenium WebDriver(Local)

In this example I’m trying to use same script like above except small tweak in conf.js page. So I copied existing config and update configuration details to run same test in multiple browsers to perform cross browser parallel testing.


In the above examples, I modified “multiCapabilities” and included firefox browser. This is the best advantage when we compare with other libraries/packages, no maintenance is needed in case of automation testing with Protractor and Selenium. Protractor supports in-build code to run cross browser automation.

image-lambdatest

This time we run both same tests in chrome and firefox which executed and pass the results. So far we have seen how to run the test in protractor for Non-Angular JS application. The below section will show how to run AngularJS application in parallel and cloud execution (using Lambdatest).

Executing Parallel Execution for AngularJS Application

To run parallel execution for AngularJS application, the configuration remains but I implement use async and await for right way to queue up events.

Make sure to disable promise manage in your config file.



Executing Cross Browser Parallel testing, Protractor & LambdaTest (Cloud)

There are always challenges and limitation to run your test with multiple version of browsers in local machines. You can’t think of installing thousands of available browser in your local machine to perform extensive, automated cross browser testing. To achieve more browser usage, remote execution in cloud is the only solution. LambdaTest offers 2000+ browsers to run your automation test scripts on their Selenium grid over a variety of devices and different browser version.

In this example, I’m going to explain how to execute cross browser parallel testing with Protractor and Selenium on LambdaTest cloud provider.

Configuration Details to run in LambdaTest:


In the above screenshot:

seleniumAddress: ‘https://:@hub.lambdatest.com/wd/hub’

User_Account: It’s your login account of LambdaTest

API_KEY: it’s access key which can be found in Profile page of your login. In case no API key, feel free to generate.

multicapabilities indicates to run your test on multiple browsers in parallel.

The other configurations mostly platform, browser specific and LambdaTest cloud provider specific to enable or disable the options.

I’m going to execute the following code on LambdaTest with Chrome and Safari in parallel.



image-lambdatest

The below results indicates the test is success and passed on lambdatest cloud platform.

image-lambdatest

Let’s take a look on example in cloud.

image-lambdatest

Detail snapshot of Test Cases in LambdaTest page for Safari Browser:

image-lambdatest

With this, we have seen how we can run simple scripts for Javascript automation testing with Protractor and Selenium WebDriver for both local and cloud execution of parallel testing.

Conclusion:

By delivering Protractor as an extensive end to end testing framework, Google has put a lot of efforts to make QA engineer works easy and protractor works like a charm. There are a lot of NPM modules available to utilize work with REST API, data generators etc along with browser automation to integrate all types of automation. All these point towards Protractor being the right choice for automated cross browser testing of AngularJS as well as Non-AngularJS application.

Written by Muthuraja R

Muthuraja R is an Automation Architect with 12+ years of experience in Test Automation, Performance, Security and Manual Testing. He is TDD BDD Enthusiast, Blogger, Technical Writer, Full Stack QA Engineer and Technology Evangelist and has a technical blog named as https://automationcalling.com/ where he provides solution, ideas sharing, techniques, framework development and address problems to all the challenges offered in the day to day activities, he can be followed up at: https://www.linkedin.com/in/muthuraja-r-b0786a25/

Related Articles

Leave a Reply