DEV Community

Cover image for Top 28 Selenium WebDriver Commands in NUnit For Test Automation
himanshuseth004 for LambdaTest

Posted on • Originally published at lambdatest.com

Top 28 Selenium WebDriver Commands in NUnit For Test Automation

Selenium Framework interacts with the web browser via the Selenium WebDriver commands. It does so with the help of certain Selenium WebDriver commands to automate browser actions such as open, close or maximise the browser window. Also, you can handle different WebElements or drop down elements browser to perform Selenium test automation.

Different programming languages such as Python, Java,C# etc uses an interface to interact with the browser. In this Nunit tutorial, I’ll be exploring Selenium commands for NUnit, which is a Selenium test automation framework for C# , the interface used through which the browser is controlled is the IWebDriver.

In this NUnit tutorial on Selenium WebDriver Commands in NUnit, I’ll take deep dive into various Selenium WebDriver Commands for web browsers, browser elements & drop down. In case you’re not familiar with ‘what is Selenium?’, you can refer to our detailed page on the topic on Selenium 4 that covers all the aspects on what features has been improvised and what functions are deprecated.

Get faster loading times and better user experience with our efficient JSON Stringify tool. Quickly compress your JSON data with ease and optimize your website now.

What are Selenium Webdriver Commands?

Selenium Webdriver commands are the methods used to run your Selenium test automation scripts. You can use these browser commands to automate different browser actions to perform testing.

Selenium WebDriver commands in NUnit are divided in three different categories on the basis of different kinds of browser interactions. The commands are categorized based on the type of interaction and the element/application on which action is being performed. Automated browser testing involves the following Selenium commands:

  1. *Web Browser Commands *— Performs actions on the web browser (e.g. open, close, maximize, etc.)

  2. *Web Element Commands *— Performs actions on the WebElements in the current window (e.g. checking a button, entering text in a textbox, clicking a button, etc.)

  3. **Drop Down Commands — **Performs actions on the drop-down elements in the current window (e.g. selecting or deselecting a value from drop-down window).

Web Browser Commands

When C# is used along with the Selenium testing framework , the IWebDriver interface is used to perform actions on the web browser. To access the methods of the IWebDriver interface, an instance/driver object from IWebDriver should be created. The complete list of methods for IWebDriver comes up as soon as you press the dot key.

Below are the Selenium WebDriver Commands in Nunit for handling browsers:

1. Url{}

Using this Selenium WebDriver command you can Get or Set the URL/web page that needs to be displayed.

Syntax:

string IWebDriver.Url { get; set;}
Enter fullscreen mode Exit fullscreen mode

Example

/* Selenium Webdriver command for URL*/
String URL;


driver = new ChromeDriver();
/* Set Operation */
driver.Url = "https://www.lambdatest.com";
/* Get Operation */
URL = driver.Url;
Enter fullscreen mode Exit fullscreen mode

2. Title{}

This Selenium WebDriver command gets the title of the current browser window.

Syntax:

string IWebDriver.Title{get;}
Enter fullscreen mode Exit fullscreen mode

Example

/* Selenium Webdriver command for getting title */
String page_title;
driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
page_title = driver.Title;
Enter fullscreen mode Exit fullscreen mode

3. PageSource{}

You can get the source of the page that is loaded by the web browser with this Selenium WebDriver command.

Syntax:

string IWebDriver.PageSource{get;}
Enter fullscreen mode Exit fullscreen mode

Example

/* Selenium Webdriver command for getting page source*/
String page_source;
driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
page_source = driver.PageSource;
Enter fullscreen mode Exit fullscreen mode

4. Quit()

You can quit the driver and close every browser window associated with this Selenium WebDriver command in NUnit.

Syntax:

void IWebDriver.Quit()
Enter fullscreen mode Exit fullscreen mode

Example

/* Selenium Webdriver command for URL*/
driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* Sleep for 4 seconds after page is displayed */
System.Threading.Thread.Sleep(4000);
/* Quit the window for this NUnit tutorial*/
driver.Quit();
Enter fullscreen mode Exit fullscreen mode

5. Close()

With close() Selenium WebDriver command, you can close the current window, quit the browser in case if it is the last window open. In case you want more detailed information on how to handle browser windows, you can refer to our blog.

Syntax:

void IWebDriver.Close()
Enter fullscreen mode Exit fullscreen mode

Example

/* Selenium Webdriver command for Closing window*/
driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
driver.Close();
Enter fullscreen mode Exit fullscreen mode

6. Navigate()

With this Selenium WebDriver command in NUnit you can navigate the browser to another location i.e. Refresh the current window/Go Back to the previous window/Go to the next page as per browsing history/Go to a particular URL.

Syntax:

INavigation IWebDriver.Navigate()
Enter fullscreen mode Exit fullscreen mode

Shown below are the different options available with the Navigate() command:

Back()

Move back a single entry as per the browser’s history.

Syntax:

void INavigation.Back()
Enter fullscreen mode Exit fullscreen mode

Example:

driver.Navigate().Back();
Enter fullscreen mode Exit fullscreen mode

Forward()

Move a single item forward as per the browser’s history

Syntax:

void INavigation.Forward()
Enter fullscreen mode Exit fullscreen mode

Example:

driver.Navigate().Forward();
Enter fullscreen mode Exit fullscreen mode

GoToUrl()

Navigate to a particular URL which is passed as a parameter to the Navigate() Selenium test automation command

Syntax:

void INavigation.GoToUrl(string url)
Enter fullscreen mode Exit fullscreen mode

Example:

driver.Navigate().GoToUrl(“https://www.lambdatest.com")
Enter fullscreen mode Exit fullscreen mode

Refresh()

Refresh the current browser window

Syntax:

void INavigation.Refresh()
Enter fullscreen mode Exit fullscreen mode

Example:

driver.Navigate().Refresh();
Enter fullscreen mode Exit fullscreen mode

Online CSS to STYLUS converter to convert CSS to Stylus. Get clean, readable code instantly. Start converting today!

Web Element Commands

While performing Selenium test automation with NUnit you’ll often have to rely on Selenium WebDriver command to perform operations on WebElements (e.g. textboxes, radio buttons, hyperlinks, etc.) on a page, that are triggered via the IWebElement interface.

To find the details of a WebElement e.g. *XPath*, outerHTML, etc.; you can make use of the Inspect Tool available in web browsers like Chrome, Firefox, etc. Once the WebElement is located, you can perform the corresponding operation on that element. To know more about how to access WebElements, you can refer to our detailed article on Selenium locators.

Shown below in this Nunit tutorial are the Selenium WebDriver command for WebElements.

To learn more about WebElements and how to interact with the elements, watch the complete video tutorials and get valuable.

To get started with your web automation journey you can Subscribe to the LambdaTest YouTube channel for details guidance on various automation testing tools, Selenium testing, Cypress testing, Playwright testing, and more.

For demonstrating the usage of the WebElement commands, we have used the the demo sites given below as for Menu system and HTML form example

Identify locators and perform seamless automation testing on the cloud platform Try LambdaTest Now!

1. Click

Using the Click() Selenium WebDriver command, you can click on a particular WebElement present on the web page. The Click operation can be performed on hyperlinks, buttons, checkboxes, or any other element that is clickable on the page. The element is first located on the page, after which the Click operation is performed.

Syntax:

void IWebElement.Click()
Enter fullscreen mode Exit fullscreen mode

Example

/*Selenium Webdriver command for click*/
driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* The Xpath of the Login Button on LambdaTest homepage */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id="navbarSupportedContent"]/ul/li[6]/a"));
web_element.Click();
Enter fullscreen mode Exit fullscreen mode

2. Enabled

You can check whether a particular WebElement is enabled or not with the Enabled Selenium WebDriver command. It returns true if the WebElement on the page is enabled else it returns false.

Syntax:

Bool IWebElement.Enabled{get;}
Enter fullscreen mode Exit fullscreen mode

Example

/*Selenium Webdriver command to check whether a particular web element is enabled */
driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* The Xpath of the Login Button on LambdaTest homepage */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id="navbarSupportedContent"]/ul/li[6]/a"));
Boolean element_enabled = web_element.Enabled;
Enter fullscreen mode Exit fullscreen mode

3. Displayed

This Selenium WebDriver command checks whether a particular WebElement is displayed or not. It returns true if the WebElement on the page is displayed else it returns false.

Syntax:

Bool IWebElement.Displayed{get;}
Enter fullscreen mode Exit fullscreen mode

Example

/*Selenium Webdriver command to check whether a particular web element is displayed */
driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* The Xpath of the Login Button on LambdaTest homepage */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id="navbarSupportedContent"]/ul/li[6]/a"));
Boolean element_enabled = web_element.Displayed;
Enter fullscreen mode Exit fullscreen mode

4. Clear

The Clear() Selenium WebDriver command clears the content in the WebElement present on the page. It is used for clearing the pre-loaded contents in a text box.

Syntax:

void IWebElement.Clear()
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* The Xpath of the Email address text box on LambdaTest homepage */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id='useremail']");
web_element.Clear();
Enter fullscreen mode Exit fullscreen mode

5. SendKeys

This Selenium Webdriver command Inputs the values in an element like a textbox on the web page.

Syntax:

void IWebElement.SendKeys(string text)
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* The Xpath of the Email address text box on LambdaTest homepage */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id='useremail']");
web_element.SendKeys("test@email.com");
Enter fullscreen mode Exit fullscreen mode

6. GetAttribute

There may be attributes and properties associated to WebElements present on a web page. These are added by the website developer. With GetAttribute() you get the value of a certain attribute as a string of the WebElement.

Syntax:

string IWebElement.GetAttribute(string attributename)
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* The Xpath of the Email address text box on LambdaTest homepage */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id='navbarSupportedContent']/ul/li[6]/a"));
String titleValue = web_element.GetAttribute("class");
Enter fullscreen mode Exit fullscreen mode

7. GetCssValue

Gets the value of a CSS property of a WebElement present on the web page. Color values are returned in the form of rgba string. For example, a “background-color” property set as “green” in the HTML source, will return “#008000” for its value.

Syntax:

string IWebElement.GetCssValue(string propertyname)
Enter fullscreen mode Exit fullscreen mode

Example:

driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* The Xpath of the Login Button on LambdaTest homepage */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id='navbarSupportedContent']/ul/li[6]/a"));
/* returns #000000 */
String cssvalue = web_element.GetCssValue("background-color");
Enter fullscreen mode Exit fullscreen mode

To get demonstrate the functionality of GetCssValue() we will be performing inspection on platform called LambdaTest. In this example we will get the background color of the ‘Login’ button on LambdaTest homepage, we check the properties associated with the element using Inspect tool.

As seen in the snapshot, background-color is the property associated with Login button. The same is used with GetCssValue().

LambdaTest is an AI-powered test orchestration and execution platform that lets you run manual and automated tests at scale with over 3000+ real devices, browsers and OS combinations. This platform allows you to perform web and mobile automation without having to worry about maintain infrastructure, security of your test data and more.

8. Submit

Performs a click on a button which is of the type submit.

Syntax:

void IWebElement.Submit()
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();
driver.Url = "https://accounts.lambdatest.com/login";
/* The Xpath of the Login Button on which is of the type submit */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id='app']/section/form/div/div/button"));
web_element.Submit();
Enter fullscreen mode Exit fullscreen mode

9. Text

Gets the innerText of a WebElement, without any leading or trailing whitespace & other whitespaces collapsed.

Syntax:

string IWebElement.Text{get;}
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* The Xpath of the Login Button on LambdaTest homepage */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id='navbarSupportedContent']/ul/li[6]/a"));
String text_value = web_element.Text;
Enter fullscreen mode Exit fullscreen mode

10. TagName

Gets the tag name of a WebElement on the web page.

Syntax:

string IWebElement.TagName{get;}
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* The Xpath of the Login Button on LambdaTest homepage */
IWebElement web_element = driver.FindElement(By.XPath("//*[@id='navbarSupportedContent']/ul/li[6]/a"));
String tag_name = web_element.TagName;
Enter fullscreen mode Exit fullscreen mode

11. Selected

Checks whether a WebElement is selected or not. The WebElement can be radio button, checkbox, etc.

Syntax:

bool IWebElement.Selected{get;}
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();
driver.Url = "https://lambdatest.github.io/sample-todo-app/";
IWebElement web_element = driver.FindElement(By.XPath("/html/body/div/div/div/ul/li[1]/input"));
bool selected_status = web_element.Selected;
Enter fullscreen mode Exit fullscreen mode

12. Size

Gets the height & width associated with a WebElement or the current browser window. The return type is of type struct size.

Syntax:

Size IWebElement.Size{get;}
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();
driver.Url = "https://www.lambdatest.com";
/* Get the window size */
Console.WriteLine(driver.Manage().Window.Size);
Enter fullscreen mode Exit fullscreen mode

Drop Down Commands

Drop down elements are common in web pages, especially when a user is registering on a website and has to enter the country/city related information. In C#, drop down operations are performed using the SelectElement class. SelectElement is declared in using OpenQA.Selenium.Support.UI package which is imported before performing any operation on the drop down box.

For demonstrating the usage of the WebElement commands, we have used the test URLs Menu/a> and formex.

Below are drop down operations in C#:

1. SelectByIndex

Select a value based on the index value. The starting index in drop down is 0.

Syntax:

void SelectElement.SelectByIndex(int index)
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();

driver.Url = "http://demos.dojotoolkit.org/dijit/tests/test_Menu.html";
IWebElement element = driver.FindElement(By.XPath("//select[@aria-label='select']"));
SelectElement select_elem = new SelectElement(element);

/* Sleep for 4 seconds after page is displayed */
System.Threading.Thread.Sleep(4000);

select_elem.SelectByIndex(1);
Enter fullscreen mode Exit fullscreen mode

2. DeselectByIndex

Deselect a selected value based on the index.

Syntax:

void SelectElement.DeselectByIndex(int index)
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();

driver.Url = "http://demos.dojotoolkit.org/dijit/tests/test_Menu.html";
IWebElement element = driver.FindElement(By.XPath("//select[@aria-label='select']"));
SelectElement select_elem = new SelectElement(element);

/* Sleep for 4 seconds after page is displayed */
System.Threading.Thread.Sleep(4000);

select_elem.DeselectByIndex(1);
Enter fullscreen mode Exit fullscreen mode

3. SelectByText

Select an option based on the text of the options available in the drop down. There is an option to do partial matching of the text and by default partial matching is False.

Syntax:

void SelectElement.SelectByText(string text, [bool partialMatch = false])
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();

driver.Url = "http://demos.dojotoolkit.org/dijit/tests/test_Menu.html";
IWebElement element = driver.FindElement(By.XPath("//select[@aria-label='select']"));
SelectElement select_elem = new SelectElement(element);

/* Sleep for 4 seconds after page is displayed */
System.Threading.Thread.Sleep(4000);

select_elem.SelectByText("on IE6");
Enter fullscreen mode Exit fullscreen mode

4. DeselectByText

Deselect an already selected option based on the text of the options available in the drop down.

Syntax:

void SelectElement.DeselectByText(string text)
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();

driver.Url = "http://demos.dojotoolkit.org/dijit/tests/test_Menu.html";
IWebElement element = driver.FindElement(By.XPath("//select[@aria-label='select']"));
SelectElement select_elem = new SelectElement(element);

/* Sleep for 4 seconds after page is displayed */
System.Threading.Thread.Sleep(4000);

select_elem.DeselectByText("on IE6");
Enter fullscreen mode Exit fullscreen mode

5. SelectByValue

Select an option based on the value supplied as input.

Syntax:

void SelectElement.SelectByValue(string value)
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();

driver.Url = "http://www.tizag.com/phpT/examples/formex.php";

IWebElement element = driver.FindElement(By.XPath("//*[@id='examp']/form/select[1]"));
SelectElement select_elem = new SelectElement(element);

/* Sleep for 4 seconds after page is displayed */
System.Threading.Thread.Sleep(4000);

select_elem.SelectByValue("HighSchool");
Enter fullscreen mode Exit fullscreen mode

6. DeselectByValue

Deselect an already selected option based on the value supplied as input.

Syntax:

void SelectElement.DeselectByValue(string value)
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();

driver.Url = "http://www.tizag.com/phpT/examples/formex.php";

IWebElement element = driver.FindElement(By.XPath("//*[@id='examp']/form/select[1]"));
SelectElement select_elem = new SelectElement(element);

/* Sleep for 4 seconds after page is displayed */
System.Threading.Thread.Sleep(4000);

select_elem.DeselectByValue("HighSchool");
Enter fullscreen mode Exit fullscreen mode

7. DeselectAll

Used to clear the selected options in multi select drop down menus.

Syntax:

void SelectElement.DeselectAll()
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();
driver.Url = "http://www.example-site.com";
IWebElement element = driver.FindElement(By.XPath("x-path"));
SelectElement select_elem = new SelectElement(element);
select_elem.DeselectAll();
Enter fullscreen mode Exit fullscreen mode

8. IsMultiple

This Selenium Webdriver command gets a value showing if the parent element supports multiple selections. If the drop down is multi select capable it returns true else otherwise it returns false.

Syntax:

bool SelectElement.IsMultiple{get;}
Enter fullscreen mode Exit fullscreen mode

Example

driver = new ChromeDriver();

driver.Url = "http://demos.dojotoolkit.org/dijit/tests/test_Menu.html";
IWebElement element = driver.FindElement(By.XPath("//select[@aria-label='select']"));

SelectElement select_elem = new SelectElement(element);
bool is_multi_select = select_elem.IsMultiple;
Console.WriteLine("Multi Select {0}", is_multi_select);
Enter fullscreen mode Exit fullscreen mode

9. Options

You can get the list of options for the select element with this Selenium WebDriver command.

Syntax:

IList<IWebElement> SelectElement.Options{ get; }
Enter fullscreen mode Exit fullscreen mode

Example

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

namespace NUnitDemo
{
    class NUnit_Demo
    {
        IWebDriver driver;

        [Test]
        public void cssDemo()
        {
            driver = new ChromeDriver();
            driver.Url = "http://demos.dojotoolkit.org/dijit/tests/test_Menu.html";

            IWebElement element = driver.FindElement(By.XPath("//select[@aria-label='select']"));

            SelectElement select_elem = new SelectElement(element);
            /* Sleep for 4 seconds after page is displayed */
            System.Threading.Thread.Sleep(4000);

            select_elem.SelectByText("on IE6");

            /* List will contain details of all the options */
            IList<IWebElement> avail_options = select_elem.Options;

            int ListSize = avail_options.Count;

            for (int loop_var = 0; loop_var < ListSize; loop_var++)
            {
                String text_value = select_elem.Options.ElementAt(loop_var).Text;
                System.Diagnostics.Debug.WriteLine("Selected item is " + text_value);
            }

        }

        driver.Close();
    }
}
Enter fullscreen mode Exit fullscreen mode

10. AllSelectedOptions

Gets all of the selected options within the select element. It is similar to *Options *except that it should be used on a multi select drop down menu.

Syntax:

IList<IWebElement> AllSelectedOptions { get; }
Enter fullscreen mode Exit fullscreen mode

Example

£
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
using System.Drawing;
using NUnit.Framework;
using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
using OpenQA.Selenium.Support.UI;

namespace NUnitDemo
{
    class NUnit_Demo
    {
        IWebDriver driver;

        [Test]
        public void cssDemo()
        {
            driver = new ChromeDriver();
            driver.Url = "http://demos.dojotoolkit.org/dijit/tests/test_Menu.html";

            IWebElement element = driver.FindElement(By.XPath("//select[@aria-label='select']"));

            SelectElement select_elem = new SelectElement(element);
            /* Sleep for 4 seconds after page is displayed */
            System.Threading.Thread.Sleep(4000);

            select_elem.SelectByText("on IE6");

            /* List will contain details of all the options */
            IList<IWebElement> avail_options = select_elem.AllSelectedOptions;

            int ListSize = avail_options.Count;
            System.Diagnostics.Debug.WriteLine("List size is " + ListSize);

            for (int loop_var = 0; loop_var < ListSize; loop_var++)
            {
                String text_value = avail_options.ElementAt(loop_var).Text;
                System.Diagnostics.Debug.WriteLine("Selected item is " + text_value);
            }

        }
        driver.Close();
    }
}
Enter fullscreen mode Exit fullscreen mode

Tired of manually creating JSON data? Generate random JSON data in seconds with our easy-to-use tool. Try random json generator now and make your development process a breeze!

It’s A Wrap!

The IWebDriver interface is the base on which the browser interactions for Selenium test automation happens. In this NUnit tutorial, I had a look at the most widely used Selenium WebDriver commands in Nunit for automated browser testing.

Using these Selenium WebDriver Tutorial commands in Nunit, you can interact with different types (and categories) of WebElements such as text boxes, drop-downs, radio buttons, and more. This forms the basis of automated browser testing with Selenium, C#, and NUnit framework.

I hope you found this NUnit tutorial informative, In case of any questions feel free to t reach out to us in the comment section down below. That’s all for now. Happy Testing!!! ?

Top comments (0)