Protractor : How to automate AngularJS application using protractor

In my last post I have discussed about protractor and how to setup Protractor environment to run protractor test script. Here I will show you how to write protractor test script and run it using WebStorm editor.

Sample application : Note that we use Super calculator as sample AngularJS application. URL :http://juliemr.github.io/protractor-demo/

Test Cases : Verify that the application can add two numbers.

1. Open the application.
2. Enter First number.
3. Select operator (+,-,*…)
4. Enter Second number.
5. Click on Go button
6. Verify the result.

Step 1 : Create a Protractor Test project

• Open Webstorm IDE. Note that WebStorm can be downloaded from JetBrain’s site. You can use any other IDE to develop protractor scripts that supports JavaScript.
• Welcome to WebStorm window is displayed and click on “Create New Project” link.

• Select the project type as “Empty Project” and path. In my case path is “C:\Development\ProtractorTest”.

• Click on Create button.

• Right click on Folder name “ProtratorTest” Folder and click on JavaScript File.

• New JavaScript File window is displayed and enter the file name “test” and click on OK button.

• Now project is ready to write test script. test.js is the file to write test.

 

Step 2 : Write test script using JavaScript

• Write the following Script to open the application in test.js file.

Here describe and it comes from Jasmine framework. We will discuss it on future.

Common syntax of describe is,

describe(feature name, function(){

………

…….});

Common syntax for it is,

it(test case title, function(){

………….

….});

In order to write a test, syntax will be,

describe(feature name, function(){

      it(test case title, function(){…..

       …….

                 });

});

browser.get(url) is a protractor command to browse an application using a url given as argument.

• Now write the following code to enter first number.

Here element() is used to find an element and by.model() is a new locator in Protractor. Protractor uses some special locator to find out angularJS element beside selenium webdriver. We will discuss more on this in a separate post.

sendKeys() is a function to enter value/string to text box.

• Now select an operator. In this case it will be addition (+).

• Now write the following code to enter second number.

• Click on Go button.

• Verify the result.

Note that we use expect(……).toEqual(…) to verify the result.

Common syntax,

expect(actual value).toEqual(expected value);

• Now script of test.js file looks like the following,

 

Step 3 : Run Protractor Test

• Add a new JavaScript file named “conf.js” at the same directory. Note that conf.js is the file name only known by protractor at run time.

• Open conf.js file and write the following code.

Here, framework is the framework name. We use jasmine framework here.

seleniumAddress is the selenium server address running on the machine.

In my case  'http://127.0.0.1:4444/wd/hub'
We may write  'http://localhost:4444/wd/hub' is place of ip address.

specs is the JavaScript file name where scripts are written using protractor. In my case it is test.js.

• Now open a terminal window by clicking on Terminal tab.

• Terminal window look like this,

• At First we have to start our selenium server. Write the following command and press enter key.

• Selenium sever starts.

• Now open another terminal window by clicking (+) button

 

• Write the following command and press enter key.

• Scripts starts running and it opens the application and execute the steps.
• It shows the results in terminal window.

Note that we can use command prompt in place of Terminal window to run protractor script. Same command will be used and in that case we need to change the directory where test.js and conf.js file is located.

In our future post we will discuss more on protractor.

Happy UI Testing with Protractor!!!

Protractor : How to install protractor environment?

Protractor is a end to end test framework for automating AngularJS application that has special angular element locating feature and it can automatically control the waiting time between two steps which selenium needs to handle using different implicit and explicit wait technique.
In our previous post we have discussed about Protractor and its features. Now how we can install protractor in our windows machine will be discussed here.

Prerequisites :
Node.js : Protractor is a Node.js program. So we need to install Node.js before installing protractor.
Jasmine : Protractor uses Jasmine Framework by default. It is not needed to install Jasmine separately.
Java Development Kit (JDK) : For running selenium Standalone server it is needed to install JDK.

Step 1 : Install JDK
How to install JDK is found in my another post. Also you can visit to Java download page to download and install JDK. You can also take help from this link to install JDK

Step 2 : Install Node.js application
Node.js is a JavaScript runtime built on Chrome's V8 JavaScript engine. It is lightweight and efficient.

• Go to Node.js download page https://nodejs.org/en/download/
• Click on the installer for windows.

• Double click on the installer file. In my case it is “node-v5.0.0-x86.msi”. A pop up window is displayed.
• Click on Run button.

• Node.js setup window is displayed. Click on Next button.

• Check on the checkbox named “I accept the terms in the License agreement”. Click on Next button.

• Keep the destination path same in this window and click on Next button.

• Click on Next button.

• Click on Install button.

• A pop up window is displayed and click on Yes button.

• Installation starts.

• Click on Finish button.

• Node.js installation is now complete.
• In order to verify that node.js is installed properly, open command prompt window by writing “cmd” text in the run text box and press Enter key from Keyboard.

• Command prompt window is displayed and type the following command.

node –version

 

• Inspect that node.js version 5.0.0 is displayed.

• It is proved that node.js is installed properly.

Step 3 : Install Protractor

• Open Command prompt typing the text “cmd” at run text box and press enter button.

• Command prompt window is displayed.

• Type the following command to install protractor globally. Note that it installs two command line tools – protractor and webdriver-manager. It also installs Protractor API (library).

npm install -g protractor

Note that we use “–g” in the command line to install protractor globally.

• Press Enter key.
  
• Protractor starts installing.

• After finishing installation type the following command to verify that protractor has been installed successfully.

protractor --version

• Press Enter key.
  
• It shows the protractor version. It means that protractor has been installed successfully.

• Now type the following update command that will install standalone selenium server and ChromeDriver.

webdriver-manager update

• Press  enter key and it starts installing.
  
• After finishing installation run the standalone selenium server to verify that it is running. We need to run it before executing protractor test script. The command will be,

webdriver-manager start

Now our environment is ready to run protractor test script. So it’s time for writing protractor test. Our next post will be on that topic.

Happy UI Testing with Protractor!!!

Node.js : How to install node.js installer in windows machine

Node.js is a JavaScript runtime built on Chrome's V8 JavaScript engine. It is lightweight and efficient.

• Go to Node.js download page https://nodejs.org/en/download/
• Click on the installer for windows.

• Double click on the installer file. In my case it is “node-v5.0.0-x86.msi”. A pop up window is displayed.
• Click on Run button.

• Node.js setup window is displayed. Click on Next button.

• Check on the checkbox named “I accept the terms in the License agreement”. Click on Next button.

• Keep the destination path same in this window and click on Next button.

• Click on Next button.

• Click on Install button.

• A pop up window is displayed and click on Yes button.

• Installation starts.

• Click on Finish button.

• Node.js installation is now complete.
• In order to verify that node.js is installed properly, open command prompt window by writing “cmd” text in the run text box and press Enter key from Keyboard.

• Command prompt window is displayed and type the following command.

node –version

 

• Inspect that node.js version 5.0.0 is displayed.

• It is proved that node.js is installed properly.