WebDriver Kullanımları

WebDriver Kullanımları

Sayfada seçilen element yüklenene kadar bekleme

using OpenQA.Selenium.Support.UI; eklenmesi gerekmektedir.

new WebDriverWait(Driver, new TimeSpan(0, 0, 5)).Until(d => d.FindElement(By.Id(waitId)));

Element bulunamadığında hata alınması

Driver.FindElement ile sayfada olmayan bir element aratıldığında "OpenQA.Selenium.NoSuchElementException" hatası alınır.

Sayfa olmayan bir element kontrolü yapılacak ise Driver.FindElements ile dönen listenin count değerine bakılabilir.

Örnek : sayfada olmayan "df" className aratıldığında;

var findElement = Driver.FindElement(By.ClassName("df"));   --> HATA : OpenQA.Selenium.NoSuchElementException

var findElement = Driver.FindElements(By.ClassName("df"));   --> List count = 0

SetAttribute kullanımı

Selenium .SetAttribute methodu desteklemediği için selenium ile javascript kodu yazılarak attribute degiştirilir.

Ayrıca bknz. https://stackoverflow.com/questions/35136773/setattribute-method-for-webelement/35136839

Örnek : Bir sayfada bulunan datetime picker alanının selenium testi.

[Test]
var js = (IJavaScriptExecutor)Driver;
js.ExecuteScript("document.getElementById('UseDate').setAttribute('value', '08.07.2019')");
js.ExecuteScript("document.getElementById('PaymentDate').setAttribute('value', '01.01.2020')");

Alert & Popup kontrolü

Sayfada Popup şeklinde açılan pencerelerin içeriğini kontrol etme ve içerisindeki butonlara erişebilmek için bknz: https://www.guru99.com/alert-popup-handling-selenium.html

Örnek : Sayfada bulunan Arama çubuğunun Selenium Testi.

Driver.SwitchTo().Alert().Text.Should().Be("Arama yapmak için en az 2 karakter yazmalısınız.");
Driver.SwitchTo().Alert().Accept();

İndirme kontrolü

İndirme işlemlerini kontolü için yapılması gereken tarayıcı ayarları bknz. Tarayıcı Ayarları

Gerekli tarayıcı ayarları yapıldıktan sonra kodu kullana biliriz;

Örnek: Bir hesaplama sayfası olsun, hesaplama detaylarının PDF olarak indirildiğini düşünelim.

İndirme kontrolü methodu

protected static void DownloandElement(string browserName, IWebElement downloadElements)
{
    if (browserName.Equals(BrowserOptionNames.Chrome))
    {
        downloadElements.Click();
        Thread.Sleep(5000);
        Directory.GetFiles(Directory.GetCurrentDirectory() + BrowserOptionNames.ChromeTemp).Length.Should().Be(1);
        Thread.Sleep(2000);
        Directory.Delete(Directory.GetCurrentDirectory() + BrowserOptionNames.ChromeTemp, true);
        Thread.Sleep(3000);
    }
    else if (browserName.Equals(BrowserOptionNames.Firefox))
    {
        downloadElements.Click();
        Thread.Sleep(5000);
        Directory.GetFiles(Directory.GetCurrentDirectory() + BrowserOptionNames.FirefoxTemp).Length.Should().Be(1);
        Thread.Sleep(2000);
        Directory.Delete(Directory.GetCurrentDirectory() + BrowserOptionNames.FirefoxTemp, true);
        Thread.Sleep(3000);
    }
}

Iframe tagının içerisinde işlem yapma

<iframe /> taginin içerisinde selenium ile işlem yapmak için, Bknz. https://www.guru99.com/handling-iframes-selenium.html

Örnek: Butonların selenium testi.

var element = Driver.SwitchTo().Frame(Driver.FindElements(By.ClassName(HtmlElementNames.Fixed_frame))[0]);
element.FindElements(By.TagName(HtmlElementNames.A))[0].Click();

Tab’lar Arasında Geçiş

Bir linke tıklandığında sayfa farklı sekmede açılabilir. Bu durumda selenium Driver’ın aktif olan sekmeye geçmesini sağlamak gerekir. Ayrıca bknz. https://stackoverflow.com/questions/29502255/is-there-a-way-to-close-a-tab-in-webdriver-or-protractor

//tarayıcıdaki tab’lar alınır.
var tabs = CurrentDriver.WindowHandles;

//1 numaralı tab’a geçmesi sağlanır.
CurrentDriver.SwitchTo().Window(tabs[1]);

//1 numaralı sekmede işlemler yapılır

//bulunulan sekme(1 numaralı tab) kapatılır
CurrentDriver.Close();

//0 numaralı tab’a geçmesi sağlanır.
CurrentDriver.SwitchTo().Window(tabs[0]);  

Local Storage Kontrolü

LocalStorage içindeki bir değişkene ulaşmak için Selenium WebDriver JS olarak çalıştırılır. JS kodu ile LocalStorage değişkenlerine ulaşılabilir.

var js = (IJavaScriptExecutor)CurrentDriver;

//getItem içerisine localStorage key ismi yazılır. Bu key’e ait değer string olarak alınır.
var cookieLocalStorageElement = (string)js.ExecuteScript("return localStorage.getItem('cookieCT')");

Tarayıcı Ekran Görüntüsü Alma

Tarayıcıda açık olan sayfanın ekran görüntüsü almak için TakeScreenshot() kullanılır. SaveAsFile("path") metoduna resmin kaydedileceği yol verilir.

string SaveAsFileImagePath = $"{uiTestExceptionsPath}\\{timestamp}.png";
….
CurrentDriver.TakeScreenshot().SaveAsFile(SaveAsFileImagePath);

Sayfa Link Değiştirildiğinde Oluşan “OpenQA.Selenium.StaleElementReferenceException" Hatası

Örnekte belirtilen durum yapıldığında aşağıdaki 2 hata alınmaktadır.

1. OpenQA.Selenium.StaleElementReferenceException : stale element reference: element is not attached to the page document

2. OpenQA.Selenium.StaleElementReferenceException : The element reference of is stale; either the element is no longer attached to the DOM, it is not in the current frame context, or the document has been refreshed

Örnek:

1. A sayfamız üzerinde bulunan linkler Selenium WebDriver ile okunarak bir değişkende tutuldu.

2. Linklerden birine tıklanarak B sayfasına gidilir, burada işlemler yapılır.

3. Daha sonra tekrar A sayfasına gidilerek 1. Adımda tutulan değişkenlerde işlem yapılmaya çalışıldığında “OpenQA.Selenium.StaleElementReferenceException” hatası alınmaktadır.

Farklı sayfalar arasında geçiş yapılıyor ise elementler değişkende tutulmamalı! Sayfa üzerinde işlem yapılacağı zaman Selenium WebDriver ile elementlere erişilerek işlem yapılmalıdır.

Link Değişmeyen Durumlarda Navigate().Back() Sorunu

Link’e tıklandığında mevcut sayfaya gidiyor ise Driver().Navigate().Back() yapıldığında browser’ın default sayfasına gider.Örnek:

1. Tarayıcı açılır ve adres çubuğuna www.foo.com yazılır.

2. Anasayfa da bulunan logo'ya tıklanır ve bu logo bizi tekrar www.foo.com adresine götürür.

3. Selenium WebDriver Navigate Back yapıldığında www.foo.com linkine gitmesi beklenir. Ancak (link değişmediği için) browser’ın default sayfasına(örnek: google.com) gider!

Örnekteki durum selenium kod yazımında sorunlara sebep olabileceğinden link’in değişmediği durumlar için dikkat edilmelidir.

Driver’da Hata Oluştuğunda ExceptionThrown Tetiklenmesi

Driver üzerinde işlem yapılırken(findElement vb.) hata oluştuğunda ExceptionThrown tetiklenmesi sağlanır. Bunun için Driver EventFiringWebDriver’dan new’lenir.

var firingDriver = new EventFiringWebDriver(CurrentDriver);

//Hata oluştuğunda ThrowsTakeScreenshot metoduna gider.
firingDriver.ExceptionThrown += ThrowsTakeScreenshot;

CurrentDriver = firingDriver;

NUnit Test Sonucu Hata Kontrolü

NUnit test sonucu TestContext.CurrentContext.Result.Outcome.Statusile öğrenilebilir.

Örnekte TearDown içerisinde test sonucu fail ise ekran görüntüsü aldırılmaktadır.

[TearDown]
public void ThrowScreenshot()
{
    if (TestContext.CurrentContext.Result.Outcome.Status == TestStatus.Failed)
    {
        var timestamp = DateTime.Now.ToString("yyyy-MM-dd-hhmm-ss");

        var uiTestExceptionsPath = $"{Directory.GetCurrentDirectory()}{BrowserOptionNames.UiTestExceptions}";

        var SaveAsFileImagePath = $"{uiTestExceptionsPath}\\{timestamp}.png";

        var exists = Directory.Exists(uiTestExceptionsPath);
        if (!exists)
        {
            Directory.CreateDirectory(uiTestExceptionsPath);
        }

        CurrentDriver.TakeScreenshot().SaveAsFile(SaveAsFileImagePath);
    }
}

DropDown Seçme

DropDown seçme işlemlerinde text değerinden seçildiğinde hata alınabilmektedir. Yapılan testlerde value değerinden seçme yapıldı.

creditCategorySelectOptionElement.SelectByValue(creditCategorySelectOption);