Selenium Yer Bulucular, web sayfasındaki web öğelerini tanımlamak için kullanılır. Selenium’da; metin kutuları, onay kutuları, bağlantılar, radyo butonları, liste kutuları ve diğer web öğeler üzerinde eylemler gerçekleştirmek için yer buluculara ihtiyacımız vardır. Konum belirleyiciler bize nesneleri tanımlamada yardımcı olur.
Selenium Yer Bulucular(Locators) Nelerdir?
- ID
- Class Name
- CSS Selector
- Name
- Xpath
- Linktext
- Partial Linktext
- Tag Name
- DOM Locator
Web Sayfasındaki Öğeleri Nasıl Buluruz?
Yukarıdaki listede verdiğim yer bulucuları kullanmadan önce web sayfası üzerindeki elementlere nasıl ulaşırız göstermek istiyorum.
1)Öncelikle otomasyon yazacağımız site içerisinde klavyeden F12’ye basarak geliştirici seçeneklerine ulaşıyoruz. Bu ekranı farklı bir pencerede yada sayfanızın solunda,sağında,aşağısında duracak şekilde açabilirsiniz(Bkz: ‘Dock Side’ görseli).
2)Burada ‘Elements’ tabını açıyoruz. Web sayfamızdaki bütün elementleri burada görebiliriz.
3)İlk 2 maddeyi bu ekranı tanımanız için yazdım ancak direk olarak ilgili elemente ulaşmak için elementin üzerine gelip(Örneğin bir ‘Oturum Aç’ butonu olabilir) sağa tıklayıp ‘İncele’ seçeneğine tıklayarak bu elemente ait yer buluculara ulaşabilirsiniz(Bkz: ‘İncele Seçeneği’ görseli).
4)Elementin bilgilerinden size uygun olan locator için gerekli bilgileri alıp otomasyonunuzda bu elemente ulaşmak için kullanabilirsiniz(Bkz: ‘Element Bilgileri’ görseli)
Yer Bulucuların Özellikleri ve Kullanımları
Selenium Web Driver’da ilgili elementleri bulabilmek için ‘findElement/findElements’ syntaxını kullanmalıyız.
1)ID
ID, web sayfasında her öğeye özgü olduğu düşünülerek öğeleri bulmanın en yaygın yoludur. World Wide Web Konsorsiyumu’na (W3C) dayalı kimlikler öğelere özgü olmalıdır ve bu nedenle öğeyi bulmak için en hızlı ve en güvenli yöntem olarak kabul edilir. Ancak ne yazık ki, tarayıcılar bu kuralı atlamaya izin verdiği için geliştiriciler bu kurala uymayabilir. Özellikle, bir tablo veya liste söz konusu olduğunda, kimlikler verilere bağlı olarak artımlı veya dinamik olarak yerleştirilebilir ve bu da bu tür öğelerin başka yollarla bulunmasını gerektirebilir. Id’nin değişken olup olmadığı sayfa yenilenerek tekrar ilgili elemente ulaşıp kontrol ederek anlaşılabilir.
Syntax: driver.findElement(By.id(“email”))
2)ClassName
ClassName locator, elementin class özelliği kullanılarak bulunmasını sağlar. Element bilgileri içerisinden ‘class = ……’ etiketindeki bilgi alınır.
Syntax: driver.findElement(By.className(“btn btn-lg btn-primary”))
3)CSS Selector
Bir elementte ID yada name ile ilgili bir bilgi yoksa veya bunlar değişken ise genellikle CSS Selector veya xpath kullanılır. xpath ile karşılaştırıldığında CSS Selector daha hızlı çalışmaktadır. Bu nedenle bir engel yoksa öncelikle CSS Selector tercih edilir.
CSS Seçicileri çeşitli biçimlerde bulunabilir:
- Tag ve ID
- Tag ve Class
- Tag ve Attribute
- Tag, Class ve Attribute
- Matches (Starts with, Ends with, Contains)
- Child elementler
4)Name
Selenium WebDriver’daki Name locator, ID gibi kullanılabilir. Birden fazla elemente sahip bir sayfada benzersiz olabilir veya olmayabilir. Aynı Name’e sahip elementler olması durumunda, konumlandırıcı sayfada bu ada sahip ilk elementi seçer. Tanımlanan Name değeri ile böyle bir değerin eşleşmemesi durumunda NoSuchElementException oluşacaktır.
Örnek element;
<input type=”email” placeholder=”Work Email*” name=”email_field” value=”” class=”form-control sign-up-input-2 “>
Syntax: driver.findElement(By.name(“email_field”))
5)Xpath
Xpath, XML ifadelerini kullanarak web sayfasındaki öğeleri bulmaya yardımcı olur.
Syntax: Xpath= //tagname[@attribute=’value’]
tagname= hedeflediğiniz elementin etiketi, örneğin bir giriş(input) etiketini veya bağlantı(anchor) etiketini, vb. belirtir.
attribute= ‘@’ ön eki ve karşılık gelen değerleri ile tanımlanır. Name, ID, Class vb. olabılır.
Xpath Seçicileri çeşitli biçimlerde bulunabilir:
- Standard Xpath
- Contains
- AND & OR
- Starts-with
- Text
6)LinkText
Elementler, bağlantı metni aracılığıyla yerleştirilebilir. Aynı metnin birden çok bağlantısının bulunduğu bir senaryoda, ilk bağlantı seçilir.
Örnek element;
<a href=”https://www.gizemgulec.com/blog” target=”_blank”>Blog</a>
Elementi bulmak için linktext kullanımı;
Syntax: driver.findElement(By.linkText(“Blog”))
7)Partial LinkText
Partial LinkText yoluyla konum belirleme normal LinkText konumlandırıcısına benzer şekilde çalışır. Selenium WebDriver’da Partial LinkText kullanılma nedeni, uzun bir bağlantı metninizin olması ve üzerinde daha fazla işlem yapmak için yalnızca kısmi metin kullanmak istediğinizden kaynaklanmaktadır. Bazen bunu kullanma amacı, ortak kısmi metne sahip bir sayfada birden çok bağlantıyı bulmak olabilir.
Örnek Elementimiz;
<a href=”https://gizemgulec.com/register” target=”_blank”>SOFTWARE TESTING TYPES <i class=”fa fa-arrow-circle-right” aria-hidden=”true”></i></a>
Elementi bulmak için Partial Link Text kullanımı;
driver.findElement(By.PartialLinkText(“TESTING“))
8)Tag Name
Adından da anlaşılacağı gibi, Selenium WebDriver’daki bu bulucu, div etiketi, etiket vb. gibi etiket adlarına sahip öğeleri tanımlamak için kullanılır.
Syntax: driver.findElements(By.tagName());
Örnekler;
driver.findElements(By.tagName(a));
driver.findElements(By.tagName(div));
driver.findElements(By.tagName(tr));
driver.findElements(By.tagName(td));
9)DOM Locator
Elementi ID ve NAme yoluyla DOM’un “getElementById” ve “getElementsByName” gibi yöntemlerini kullanarak tanımlayabiliriz. GetElementById yöntemi bir kerede yalnızca bir öğeyi bulur, diğer yöntem ise bu adla bulunan bir dizi elementi sağlamak için kullanılır. Bir dizi elementin olması durumunda belirtilen spesifik bir öğeye erişmek için index kullanabiliriz.
Syntax:
document.getElementById (“id”)
document.getElementsByNames (“name”)[index]
Bu yazımda size Selenium Web Driver’da Locator’ların kullanımını anlatmaya çalıştım. Umarım faydalı olmuştur