NCS.Globals 0.0.8

Globals

Description

Will have the base logic of using Playwright and Selenium. Will be hosted on a Nuget feed for the other projects to use.

Installing Nuget

In the package manager console Install-Package NCS.Globals

Project Setup

Playwright

NUnit

• Add Package Microsoft.Playwright.NUnit
• Add the following usings

  using Microsoft.Playwright.NUnit;
  using NCS.Globals.Playwright;
  using NCS.Globals.Configuration;
  

• Make your Test Class/s inherit from the type PageTest from playwright

      public class PlaywrightTests: PageTest
      {
      }
  

• Create a locators.json file in a directory. Example can be found here
• Load file in test setup. Can be fixture or one time setup.

  [SetUp]
  public async Task Setup()
  {
      Locators.ReadConfigFile(@"../../../Resources/playwright-locators.json");
      BrowserContextConfiguration.ReadConfigFile(@"../../../Resources/playwright-runsettings.json");
      await BrowserContext.CreatePage();
  }
  

MS Test

• Add Package Microsoft.Playwright.MSTest
• Add the following usings

  using Microsoft.Playwright.MSTest;
  using NCS.Globals.Playwright;
  using NCS.Globals.Configuration;
  

• Make your Test Class/s inherit from the type PageTest from playwright

      public class PlaywrightTests: PageTest
      {
      }
  

• Create a locators.json file in a directory. Example can be found here
• Load file in test setup. Can be fixture or one time setup

  WIP
  

Selenium

NUnit

• Add the following usings

      using OpenQA.Selenium.Chrome; //this can be any Selenium browser driver
      using NCS.Globals.Selenium;
      using NCS.Globals.Configuration;
  

• Create a locators.json file in a directory. Example can be found here
• Load file in test setup. Can be fixture or one time setup.

      [SetUp]
      public void Setup()
      {
          BasePage._driver = new ChromeDriver(); // uses the NCS.Globals.Selenium.BasePage class to set the IWebDriver.
          Locators.ReadConfigFile(@"../../../Resources/selenium-locators.json");
      }
  

XUnit

Coming Soon

MSTest

Coming Soon

How to Use

Once the project is setup users can interact with locators declared in the json file by calling classes from globals. The selenium web element and Playwright locators are built under the hood depending on which BasePage class is being called.

Playwright Examples

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Playwright.NUnit;
using NCS.Globals.Playwright;
using NCS.Globals.Configuration;

namespace NCS.UnitTests.Tests
{
    public class PlaywrightTests: PageTest
    {
        [SetUp]
        public async Task Setup()
        {
            Locators.ReadConfigFile(@"../../../Resources/playwright-locators.json");
            BrowserContextConfiguration.ReadConfigFile(@"../../../Resources/playwright-runsettings.json");
            await BrowserContext.CreatePage();
        }

        [Test]
        public async Task ClickOnElement()
        {
            await BasePage.GoTo("https://playwright.dev/dotnet/");
            await BasePage.ClickElement("Example Name 1", "Home Page");
        }

        [TearDown]
        public void TearDown()
        {

        }
    }
}

Selenium Examples

using OpenQA.Selenium.Chrome;
using OpenQA.Selenium;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using NCS.Globals.Selenium;
using NCS.Globals.Configuration;

namespace NCS.UnitTests.Tests
{
    public class SeleniumTests
    {

        [SetUp]
        public void Setup()
        {
            BasePage._driver = new ChromeDriver();
            Locators.ReadConfigFile(@"../../../Resources/selenium-locators.json");
        }

        [Test]
        public async Task ClickOnElement()
        {
            await BasePage.GoTo("https://www.selenium.dev/");
            await BasePage.ClickElement("Example Name 1");
        }

        [Test]
        public async Task DragAndDrop()
        {
            await BasePage.GoTo("https://the-internet.herokuapp.com/?ref=hackernoon.com");
            await BasePage.ClickElement("Drag and Drop Link");
            await BasePage.DragAndDrop("Drag and Drop A", "Drag and Drop B");
        }

        [Test]
        public async Task DropdownList()
        {
            await BasePage.GoTo("https://the-internet.herokuapp.com/dropdown");
            await BasePage.SelectFromDropdownText("Dropdown List", "Option 1");
            await BasePage.SelectFromDropdownIndex("Dropdown List", 2);
        }

        [Test]
        public async Task FillFieldsIn()
        {
            await BasePage.GoTo("https://the-internet.herokuapp.com/login");
            await BasePage.FillInField("Username field", "tomsmith");
            await BasePage.FillInField("Password field", "SuperSecretPassword!");
            await BasePage.ClickElement("Login button");
        }

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