Ana içeriğe atla

TestNG - Notasyonlar (Annotations), Doğrulamalar (Assertions)

TestNG, JUnit ve NUnit kütüphanelerinden etkilenen ve onlara göre daha fazla yetkinlik barındıran bir test kütüphanesidir.
TestNG ait özellikler ve kolaylıklar için şunları örnek verebiliriz:
  • Notasyonlar (Annotations)
  • Testlerin kendine has Thread’lerde koşabilmesi
  • testng.xml dosyasıyla testlerin önceliklendirilmesi, gruplandırılması vb. kolaylıklar
  • Kendi içerisinde loglama, raporlama desteği
  • Notasyonlar sayesinde kodun ve oluşturulan raporun kolaylıkla anlaşılması
  • @DataProvider notasyonu sayesinde veriye dayalı test desteği (Data Driven Test)
  • Maven, Jenkins vb. ide ler için eklenti desteği
  • Parametre desteği

Notasyonlar:

@Test Notasyonu

Yazılan otomasyon kodunda test olarak çalışmasını istediğimiz kod parçasının önüne bu notasyonu ekleriz. Bu notasyonu birden fazla kez kullanabiliriz. Eğer herhangi bir parametre tanımlanmadıysa testler alfabetik olarak çalışır. 

Aşağıdaki parametreler, hangi testin hangi sırayla çalışacağının, koşturulup koşturulmayacağının, birbirleriyle olan bağımlılıklarının, gruplandırılmalarının ve ne için çalıştıklarının belirtilmesine olanak sağlar.

Tanım: Testin ne yaptığını, açıklamasını aşağıdaki gibi tanımlayabilirsiniz.

@Test(description=”This test validates login functionality”).

Öncelik: Test yöntemlerinizi önceliklendirebilirsiniz. TestNG, düşük değerden yüksek değere doğru çalıştırır testleri.

@Test(priority=1)

Bağımlılık: Birbirine bağımlı olan test case'iniz için bu özelliği kullanabilirsiniz. Örneğin bir siteye ait profil bilginizi görmek için o siteye giriş yapmanız gerekir. Yani profil bilginizi görmek için yazdığınız test bloğu, o profile giriş yaptığınız test bloğuna baglıdır.

@Test(dependsOnMethod=”Login”)

Etkin: Bu özellik ile herhangi bir test case'in çalıştırılıp çalıştırılmayacağını belirtebilirsiniz.

@Test(enabled=’true’)

Gruplar: Bu özellik ile ise test case'lerinizi bir gruba alabilirsiniz, çalışmasını istediğiniz test grubunun TestNG XML dosyasında belirterek sadece bu grubun çalışmasını sağlayabilirsiniz. Böylelikle diğerleri koşturulmaz.

@Test(groups=”Smoke Suite”)

@BeforeMethod Notasyonu

Bu notasyonun tanımlandığı yöntem, her test yönteminden önce çalıştırılır.

@AfterMethod Notasyonu

Bu notasyonun tanımlandığı yöntem, her test yönteminden sonra çalıştırılır.

@BeforeClass Notasyonu

Bu notasyonun tanımlandığı yöntem, ilk test yönteminden önce bir kere çalıştırılır.

@AfterClass Notasyonu

Bu notasyonun tanımlandığı yöntem, sınıftaki testler çalıştıktan sonra bir kere çalıştırılır.

@BeforeTest Notasyonu

@Test notasyonundan önce çalıştırılır. 

@AfterTest Notasyonu

@Test notasyonundan sonra çalıştırılır.

@BeforeSuite Notasyonu

Suite'deki herhangi bir test çalışmadan önce çalıştırılır.

@AfterSuite Notasyonu

Suite'deki bütün testler çalıştıktan sonra çalıştırılır.

Bu notasyonların çalışma sırası aşağıdaki gibidir:

@BeforeSuite -> @BeforeTest -> @BeforeClass -> @BeforeMethod -> @Test -> @AfterMethod -> @AfterClass -> @AfterCTest -> @AfterSuite

@BeforeMethod ve @AfterMethod, her  @Test yönteminden önce çalışır, diğerleri sadece bir kez çalışır.

Assertion'lar (Doğrulamalar)

TestNG'de beklediğiniz sonuç ile gerçek sonucu karşılaştırabileceğiniz assertionlar mevcuttur. Bu assertion'lar hard assertion olarak tanımlanır. Nedeni ise, istenilen koşul gerçeklenmediğinde ilgili testin başarısız olması, sonlandırılması ya da varsa sonraki @Test notasyonuna geçilmesidir.

assertTrue : Bu assertion, tanımlanan koşulun doğru olup olmadığını doğrular. Eğer doğruysa, test başarılı olur. Aksi takdirde, test başarısız olur
Assert.assertTrue (koşul);

assertFalse : Bu assertion, tanımlanan koşulun yanlış olup olmadığını doğrular. Eğer yanlışsa, test senaryosu geçecektir. Aksi takdirde, test başarısız olur
Assert.assertFalse (koşul);

assertEquals : Bu iddia, beklenen değeri gerçek değer ile karşılaştırır. Her ikisi de aynıysa, test senaryosundan geçer. Değilse, test senaryosunda başarısız olur. Bu assert'i kullanarak dizeleri, nesneleri, tamsayı değerlerini vs. karşılaştırabilirsiniz.
Assert.assertEquals (gerçek, beklenen);

assertNotEquals : Bu, assertEquals'in yaptıklarının tam tersidir. Gerçek beklenenle eşleşirse, test durumu başarısız olur, aksi takdirde test durumu geçer
Assert.assertNotEquals (gerçek, beklenen Mesajı);

assertNull : Bu assertion bir objenin boş olup olmadığına bakar, boş ise hata verir ve test başarısız olur.
Assert.assertNull (object);

assertNotNull : Bu assertion, assertNull'ın tersini yapar. Eğer bir obje boş değilse hata verir ve test başarısız olur.
Assert.assertNotNull (object);

assertSame : İki nesnenin aynı nesneyi hitaben parametre olarak verilip verilmediğini kontrol eder. Sağlanan nesneler verilen iletiyle aynı nesneye hitap etmiyorsa, bir AssertionError verir.

Assertion'larda dikkat edilmesi gereken önemli bir kısım, assertion'lar başarısız olursa testlerin bir sonraki kod satırına geçmez. Otomatik olarak bir sonraki @test notasyonuna atlayacaktır.

*Eğer test başarısız olsa bile ilgili kodun çalışmasına devam etsin istiyorsanız softAssert kullanabilirsiniz. Bunu kullandığınızda alınan hata kodun çalışmasına engel olmayacak, hata TestNG'nin oluşturduğu raporda gösterilecektir.

Yorumlar

Bu blogdaki popüler yayınlar

Selenium Actions Sınıfını Kullanarak Klavye ve Fare İşlemleri

Karmaşık kullanıcı hareketlerini (sağ tıklama, iki kere tıklama, sürükleme,...) taklit etmek için kullanılan API. Doğrudan Klavye veya Fare kullanmak yerine bu sınıf kullanılır. Build patternini uygular: yöntem çağrıları tarafından belirtilen tüm eylemleri içeren bir CompositeAction oluşturur. Kullanıcı hareketlerini uygulayan fonksiyonları kullanmak için Actions ve Action sınıfını import etmek gerekir: Actions sınıfı ve Action sınıfı, WebDriver API'sinin org.openqa.selenium.Interactions paketinde bulunur. import org.openqa.selenium.interactions.Actions; import org.openqa.selenium.interactions.Action; Yöntemlerini kullanmaya çağırmak için Actions sınıfı nesnesine ihtiyaç vardır.  Actions actions = new Actions(WebDriver nesnesi); Üzerinde işlem yapılacak elementi bulmak gerekiyor. WebElement webElement = driver.findElement(...);  actions.contextClick(webElement).perform(); //contextClick, element üzerinde sağ tıklar. Bu sınıfının bazı fonksiyonl...

Selenium WebDriver - Dinamik Web Tablolarla Kod Örnekleri

Verisi sürekli değişen tablolarda XPath kullanılması gerekir. Bunu da tablonun satır ve sütun sayı bilgileriyle yapmak daha doğru olur. Tablo 1: Şirket Grup Kapanış Şimdiki Ücret % Değişim IL&FS Transportation A 337.4 66.5 + 5.4 GRUH Finance Li A 383.8 998.9 + 2.3 IDFC Bank A 351.4 715.9 + 5.1 YES Bank Ltd. A 697.9 669.3 + 3.2 IRB Infrastructure A 271 724.8 + 3.1 Escorts Ltd. A 113.4 890.3 + 5.1 Cox & Kings L A 867 900.8 + 5.5 Bharat Electroni A 176.5 849 + 7.5 Nestle India A 64.8 187.3 + 7.6 Cox & Kings L A 749.4 729.5 + 9.5 JK Tyre & Industries A 687 601.4 + 6 Navin Fluorine Inter A 416.7 865.3 + 8.9 NIIT Technologies A 966.9 117.2 + 9.4 DCB Bank A 853.2 760.2 + 2.4 UCO Bank A 358 719.6 + 9 Coffee Day Enterpris A 53.8 538.6 + 4.1 Kirloskar Oil Engine A 134.1 102.8 + 7.7 Repco Home Finance L A 96.2 449.9 + 8.9 Ajanta Pharma Lt A 161.3 838 + 4.4 CESC Ltd. A 817 490.5 + 4.7 JaiprakashAssociates A 247.3 961.1 + 7.1 Vakrangee A 888.3 652.9 ...