Selenium C# Webdriver Tutorial: NUnit Example

Selenium Overview:

Selenium is an open-source, web Automation Testing tool that supports multiple browsers and multiple operating systems. It allows testers to use multiple programming languages such as Java, C#, Python, .Net, Ruby, PHP, and Perl for coding automated tests.

C# Overview:

C# is an object-oriented programming language derived from C++ and Java. C# allows developers to build applications using Visual Studio on .Net platform. The following are the key features of C#.

1. It is an Object-Oriented programming language
2. It supports the development of console, windows and web-based applications
3. It provides features such as Encapsulation, Inheritance, and Polymorphism.

Basic Syntax of C#:

A program in C# need to contain the following sections

1. Namespace declaration
2. Classes
3. Class Attributes and Methods
4. Main method
5. Program statements

Example-

Below is a sample Selenium C# example program to print the text 'Guru99' on the system console.

using System;
namespace FirstProgram {
class DemoPrint {
static void main(){
    Console.WriteLine("Guru99");
	}
  }
}

Explanation:

• A namespace in the above Selenium C# example is a collection of multiple classes. Each namespace must be declared using the keyword 'using'.
• The first statement of the code includes the namespace 'System' into our program. System namespace defines the fundamental classes and events used in C#. The namespace to be used depends on the program requirement.
• The second statement is declaring a namespace "FirstProgram" for the class "DemoPrint." A C# file can contain multiple classes within the same namespace.
• The third statement includes the class declaration. A class may contain multiple attributes and multiple methods.
• The fourth statement includes a declaration of the Main method. The main method is the entry point of execution for each class.
• The last statement is the C# syntax used for printing a statement to console. WriteLine is a method of the class 'Console.

Set Up Visual Studio with Selenium WebDriver:

Now in this Selenium C# tutorial, let's learn the step by step process to set up Visual Studio with Selenium WebDriver:

Visual Studio is an Integrated Development Environment (IDE) that is used by developers to build applications across multiple platforms such as Windows, Android, iOS and Cloud-based applications.

Step 1) Navigate to the URL https://visualstudio.microsoft.com/downloads/ and Click on the 'Free download' button displayed on Visual Studio Community 2017 tab

Step 2) Open the exe downloaded. Click on 'Yes' if asked for Admin Rights.

Step 3) The below popup will appear. Click on 'Continue' button.

Files will be downloaded as shown in the popup below.

Step 4) In the next screen,

Select the checkboxes for

• Universal Windows Platform development
• Net desktop development

Click on 'Install.'

Wait for installation of each component to complete. Files are 16GB in size and will take time.

Step 5) The below pop up will be displayed. Click on 'Restart' button.

Step 6) Once the machine is restarted, search for "Visual Studio 2017" on the start menu and click on the search result. The following popup will appear. Click on "Not now, maybe later" link if you do not have an existing account.

Step 7) In the next screen,

• Select color theme of your liking
• Click the button "Start Visual Studio'"

Step 8) Visual Studio 'Get Started' screen will appear.

Create a new project in Visual Studio:

Step 1) In the File Menu, Click New > Project

Step 2) In the next screen,

1. Select the option 'Visual C#'
2. Click on Console App (.Net Framework)
3. Enter name as "Guru99"
4. Click OK

Step 3) The below screen will be displayed once the project is successfully created.

Set up Visual Studio with Selenium WebDriver:

Step 1) Navigate to Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution

Step 2) In the next screen

1. Search for Selenium on the resultant screen
2. Select the first search result
3. Check the project checkbox
4. Click on 'Install'

Step 3) Click on 'OK' button in the pop-up screen

Step 4) The below message will be displayed once the package is successfully installed.

NUnit Framework: Overview

NUnit is the Unit Testing framework supported by Visual Studio and Selenium WebDriver. NUnit is the most widely used Unit Testing framework for .Net applications. NUnit presents the test results in a readable format and allows a tester to debug the automated tests.

We need to install NUnit Framework and NUnit Test Adapter onto Visual Studio inorder to use it.

Steps to install NUnit Framework:

Now in this Selenium with C# tutorial, let's learn the process to install NUnit framework:

1. Navigate to Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution

Step 2) In the next window

1. Search for NUnit
2. Select the search result
3. Select Project
4. Click Install

Step 3) The below popup will appear. Click on 'Ok' button.

Step 4) The below message will appear once the installation is complete.

Steps to download NUnit Test Adapter

Now in this NUnit tutorial, we will cover the steps to download NUnit Test Adapter:

Please note that the below steps work only for 32-bit machines. For 64-bit machines, you need to download the 'NUnit3 Test Adapter' by following the same process as mentioned below.

Step 1) Navigate to Tools ->NuGet Package Manager -> Manage NuGet Packages for Solution. In that screen,

1. Search NUnitTestAdapter
2. Click Search Result
3. Select Project
4. Click Install

Step 2) Click OK on the confirmation pop-up. Once install is done you will see the following message-

Selenium and NUnit framework:

Integration of selenium with NUnit framework allows a tester to differentiate between various test classes. NUnit also allows testers to use annotations such as SetUp, Test, and TearDown to perform actions before and after running the test.

NUnit framework can be integrated with Selenium by creating a NUnit test class and running the test class using NUnit framework.

Below steps in this Selenium C# framework tutorial are needed to create and run a test class using NUnit framework.

Steps to create a NUnit Test class in Selenium:

Step 1) In the Solution Explorer, Right click on project > Add > Class

Step 2) Class creation window will appear.

1. Provide a name to the class
2. Click on Add button

Step 3) The below screen will appear.

Step 4) Add the following code to the created class. Please note that you need to specify the location of 'chromdriver.exe' file during chrome driver initialization.

using NUnit.Framework;
using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
using OpenQA.Selenium.Firefox;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Guru99Demo
{
	class Guru99Demo						
    {
        IWebDriver driver;

        [SetUp]
		public void startBrowser()
        {
            driver = new ChromeDriver("D:\\3rdparty\\chrome");
        }

        [Test]
		public void test()
        {
            driver.Url = "http://www.google.co.in";
        }

        [TearDown]
		public void closeBrowser()
        {
            driver.Close();
        }

    }
}

Step 4) Click on 'Build' -> 'Build Solution'

NOTE: You may get an error like "Does not contain a static 'main' method suitable for an entry point" when you build

To resolve this Got to Project > Properties and change Output Type to "Class Library." The default is "Console Application."

Step 5) Once the build is successful, we need to open the Test Explorer window. Click on Test -> Windows -> Test Explorer

Step 6) Test Explorer window opens with the list of available tests. Right-click on Test Explorer and select Run Selected Tests

Step 7) Selenium must open the browser with specified URL and close the browser. Test case status will be changed to 'Pass' on the Test Explorer window.

Selenium WebDriver Commands in C#:

C# uses the interface 'IWebDriver' for browser interactions. The following are the category of commands available with Selenium in C#.

1. Browser commands
2. Web Element commands
3. Dropdown commands

Now in the Selenium C Sharp tutorial, let's study the Selenium WebDriver commands one by one

Browser commands:

Following is a list of browser commands available in C# with Selenium.

driver.Url = "https://www.guru99.com"

String title = driver.Title

String pageSource = driver.PageSource

driver.Close();

driver.Quit();

driver.Navigate().Back();

driver.Navigate().Forward()

driver.Navigate().Refresh()

Webelement Commands:

A Webelement represents all the elements on a web page. They are represented by HTML tags. Each of the buttons, textboxes, links, images, tables, and frames fall under Webelements. Operations on web elements can be triggered using the IWebelement interface. To interact with a Webelement, we need to find the element on the webpage and then perform operations on it. Tools like Firebug and Firepath can be used to identify the Xpath of Webelement.

The following are the list of Webelement commands available in C#.

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement"));  element.Click();

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
element.Clear();

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
element.SendKeys("guru99");

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
Boolean status = element.Displayed;

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
Boolean status = element.Enabled;

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
Boolean status = element.Selected;

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement"));  element.submit();

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
String text=element.Text;

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement"));  String tagName = element.TagName;

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
String color = element.getCSSValue;

Dropdown Commands:

Dropdown operations in C# can be achieved using the SelectElement class.

The following are the various dropdown operations available in C#.

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
SelectElement select = new SelectElement(element);
select.SelectByText("Guru99");

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
SelectElement select = new SelectElement(element);
select.SelectByIndex("4");

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
SelectElement select = new SelectElement(element);
select.SelectByValue("Guru99");

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
SelectElement select = new SelectElement(element);
List<IWebelement> options = select. Options;
int size = options.Count;
for(int i=0;i<options.size();i++)
{
String value = size.elementAt(i).Text;
Console.writeLine(value);
}

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
SelectElement select = new SelectElement(element);
Boolean status = select.IsMultiple();

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
SelectElement select = new SelectElement(element);
select.DeSelectAll();

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
SelectElement select = new SelectElement(element);
select.DeSelectByIndex("4");

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
SelectElement select = new SelectElement(element);
select.DeSelectByValue("Guru99");

IWebelement element = driver.FindElement(By.xpath("xpath of Webelement")); 
SelectElement select = new SelectElement(element);
select.DeSelectByText("Guru99");

Code Samples

Example 1: Click on a link using XPATH Locator:

Test Scenario:

1. Navigate to Demo Guru99 web page - http://demo.guru99.com/test/guru99home/
2. Maximize the window
3. Click on the 'Testing' menu
4. Close the browser

using NUnit.Framework;
using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Guru99Demo
{
	class CSS						
    {
        IWebDriver m_driver;

        [Test]
		public void cssDemo()
        {
            m_driver = new ChromeDriver("D:\\3rdparty\\chrome");
            m_driver.Url = "http://demo.guru99.com/test/guru99home/";
            m_driver.Manage().Window.Maximize();
            IWebelement link = m_driver.FindElement(By.XPath(".//*[@id='rt-header']//div[2]/div/ul/li[2]/a"));
            link.Click();
            m_driver.Close();
        }
    }
}

Example 2: Entering data into TextBox and Click on a button using XPATH locator:

Test Scenario:

1. Navigate to Guru 99 demo page - http://demo.guru99.com/test/guru99home/
2. Enter data into email text box
3. Click on sign up button

using NUnit.Framework;
using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Guru99Demo
{
	class CSS						
    {
        IWebDriver m_driver;

        [Test]
		public void cssDemo()
        {
            m_driver = new ChromeDriver("G:\\");
            m_driver.Url = "http://demo.guru99.com/test/guru99home/";
            m_driver.Manage().Window.Maximize();

             
			// Store locator values of email text box and sign up button				
            IWebElement emailTextBox = m_driver.FindElement(By.XPath(".//*[@id='philadelphia-field-email']"));
            IWebElement signUpButton = m_driver.FindElement(By.XPath(".//*[@id='philadelphia-field-submit']"));

            emailTextBox.SendKeys("This email address is being protected from spambots. You need JavaScript enabled to view it.");
            signUpButton.Click();
                        
        }
    }
}			

Example 3: Entering data into TextBox and Click on a button using CSS locator:

Test Scenario:

1. Navigate to Guru 99 demo page - http://demo.guru99.com/test/guru99home/
2. Enter data into email text box
3. Click on sign up button

using NUnit.Framework;
using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Guru99Demo
{
	class CSS						
    {
        IWebDriver m_driver;

        [Test]
		public void cssDemo()
        {
            m_driver = new ChromeDriver("G:\\");
            m_driver.Url = "http://demo.guru99.com/test/guru99home/";
            m_driver.Manage().Window.Maximize();

             
			// Store locator values of email text box and sign up button				
            IWebElement emailTextBox = m_driver.FindElement(By.CssSelector("input[id=philadelphia-field-email]"));
            IWebElement signUpButton = m_driver.FindElement(By.CssSelector("input[id=philadelphia-field-submit]"));

            emailTextBox.SendKeys("This email address is being protected from spambots. You need JavaScript enabled to view it.");
            signUpButton.Click();

             
        }
    }
}

Example 4: Select a value in the dropdown:

Test Scenario:

1. Navigate to Guru 99 demo page - http://demo.guru99.com/test/guru99home/
2. Click on SAP link
3. Enter data onto name and email text boxes
4. Select a value from the Course dropdown
5. Close the browser

using NUnit.Framework;
using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
using OpenQA.Selenium.Support.UI;


namespace Guru99Demo
{
	class TestSelect						
    {
        IWebDriver m_driver;

        [Test]
		public void selectDemo()
        {
            m_driver = new ChromeDriver("G:\\");
            m_driver.Url = "http://demo.guru99.com/test/guru99home/";
            m_driver.Manage().Window.Maximize();

            IWebElement course = m_driver.FindElement(By.XPath(".//*[@id='awf_field-91977689']"));

			var selectTest = new SelectElement(course);
			// Select a value from the dropdown				
            selectTest.SelectByValue("sap-abap");
                        
        }
    }
}

Summary:

• In order to use Selenium WebDriver with C#, you need to install Visual Studio.
• NUnit is the Unit Testing framework supported by Visual Studio and Selenium webdriver
• We need to install NUnit Framework and NUnit Test Adapter onto Visual Studio inorder to use it.
• NUnit framework can be integrated with Selenium by creating a NUnit test class and running the test class using NUnit framework.
• NUnit also allows testers to use annotations such as SetUp, Test, and TearDown to perform actions before and after running the test.
• Selenium WebDriver Commands can be categorized into Browser commands, Webelement Commands and Dropdown Commands.

This article is contributed by Sneha Gudapati