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ı fonksiyonları:

clickAndHold () Geçerli fare konumuna (serbest bırakmadan) tıklar.

contextClick () Geçerli fare konumunda sağ tıklar. (Sağ Tıklama İşlemi)

doubleClick () Geçerli fare konumunda çift tıklama gerçekleştirir.

dragAndDrop (kaynak, hedef) Kaynak öğenin konumunda tıklayıp bekletir, hedef öğenin konumuna gider, sonra fareyi serbest bırakır.

Parametreler:

kaynak-elementin tutulduğu yer.

hede-elementin götürüleceği ve farenin serbest bırakılacağı yer

dragAndDropBy (kaynak, x-offset, y-offset) Kaynak öğenin konumunda tıklayıp bekletir, belirli bir ofset tarafından hareket eder ve ardından fareyi serbest bırakır.

Parametreler:

kaynak-elementin tutulduğu yer

xOffset-yatay hareket ofseti.

yOffset - dikey hareket ofseti.

keyDown (modifier_key) Bir değiştirici tuşa basma işlemini gerçekleştirir. Değiştirici tuşu serbest bırakmaz - sonraki etkileşimler basılı tutulduğunu varsayabilir. 

Parametreler:

modifier_key - değiştirici tuşlardan herhangi biri (Keys.ALT, Keys.SHIFT veya Keys.CONTROL)

keyUp (değiştirici _key) Bir anahtar bırakma işlemi gerçekleştirir.

Parametreler:

modifier_key - değiştirici tuşlardan herhangi biri (Keys.ALT, Keys.SHIFT veya Keys.CONTROL)

moveByOffset (x-offset, y-offset) Fareyi mevcut konumundan (veya 0,0) belirtilen ofsete hareket ettirir.

Parametreler:

x-uzaklık-yatay sapma. Negatif bir değer, fareyi sola hareket ettirmek anlamına gelir.

y-sapma - dikey sapma. Negatif bir değer, fareyi aşağı hareket ettirmek anlamına gelir.

moveToElement (toElement) Fareyi öğenin ortasına taşır.

Parametreler:

toElement-taşınacak element.

release () Geçerli fare konumundaki basılan sol fare düğmesini serbest bırakır

sendKeys (onElement, charsequence) Öğeye bir dizi tuş vuruşu gönderir.

Parametreler:

onElement - tuş vuruşlarını alacak olan eleman, genellikle bir metin alanı

charsequence - gönderilecek tuş vuruşlarının sırasını temsil eden herhangi bir dize değeri

Örnek:

Blogtaki arama butonuna tıklayıp "git komutlar" metnini büyük harflerle yazdırma kodu aşağıdadır.

  @Test

public void KeyboardAndMouse() throws InterruptedException{

    driver.get("http://sinemayk.blogspot.com/");    Actions action = new Actions(driver);    WebElement araButonu = driver.findElement(By.xpath("//button[@class='search-expand touch-icon-button']"));    Action click = action.moveToElement(araButonu).click().keyDown(araButonu, Keys.SHIFT).sendKeys("git komutlar").keyUp(araButonu, Keys.SHIFT).build();    click.perform();    Thread.sleep(5000);    System.out.println("GİT KOMUTLAR yazısı yazıldı");}

*build fonsiyonunu son yazarak birden fazla fonksiyonu peşpeşe kullanabilirsiniz.
*Thread.sleep in amacı sadece yazılanı gözle görmek, kullanmayabiliriz.