Drag and Drop Activity

Overview

The Drag activity allows you to drag and drop elements in the browser using the Screenplay Pattern.

Usage

Basic Usage

import com.teststeps.thekla4j.browser.core.Element;
import com.teststeps.thekla4j.browser.core.locator.By;
import com.teststeps.thekla4j.browser.spp.activities.Drag;
import com.teststeps.thekla4j.browser.spp.abilities.BrowseTheWeb;
import com.teststeps.thekla4j.browser.selenium.Selenium;
import com.teststeps.thekla4j.core.base.persona.Actor;

class DragAndDropExample {
    
    public static void main(String[] args) {
        // Setup actor with browser capability
        Actor actor = Actor.named("Test User")
            .whoCan(BrowseTheWeb.with(Selenium.browser().build()));
        
        // Define elements
        Element draggableElement = Element.found(By.css("#draggable"))
            .called("draggable item");
        
        Element dropZone = Element.found(By.css("#dropzone"))
            .called("drop zone");
        
        // Perform drag and drop
        actor.attemptsTo(
            Drag.element(draggableElement).to(dropZone)
        );
    }
}

With Retry

// Drag and drop with automatic retry on failure

Actor actor = Actor.named("Tester");

actor.attemptsTo(
    Drag.element(draggableElement).to(dropZone).retry()
);

Using runAs

// Direct execution with runAs
Drag.element(draggableElement).to(dropZone).runAs(actor);

Implementation Details

The Drag activity is implemented using Selenium’s Actions class with the dragAndDrop() method. It supports:

Selenium: Full drag and drop support using WebDriver Actions API
Appium: Mobile drag and drop support (delegates to Selenium implementation)
Frame Support: Both source and target elements should be in the same frame context

Method Chain

Drag.element(sourceElement) - Creates a new Drag activity with the source element
.to(targetElement) - Specifies the target element where the source should be dropped
.runAs(actor) or via actor.attemptsTo() - Executes the drag and drop action

Error Handling

If the target element is not specified, an ActivityError is returned with the message:

No target element specified. Did you set the target element with Drag.element(SOURCE).to(TARGET)?

Example Test

import org.junit.jupiter.api.Test;

class DragAndDropTest {
    
    @Test
    void shouldDragElementToDropZone() {
        Actor user = Actor.named("User")
            .whoCan(BrowseTheWeb.with(Selenium.browser().build()));
        
        Element item = Element.found(By.id("item1"));
        Element target = Element.found(By.id("target-zone"));
        
        user.attemptsTo(
            Navigate.to("https://example.com/drag-drop"),
            Drag.element(item).to(target)
        );
        
        // Verify the item was moved
        user.attemptsTo(
            See.ifThe(Text.of(target))
            .is(Expected.to.equal("item1"))
        );
    }
}

Browser Support

Browser Implementation	Support Status
Selenium (Chrome)	✅ Supported
Selenium (Firefox)	✅ Supported
Selenium (Edge)	✅ Supported
Selenium (Safari)	✅ Supported
Appium (Mobile)	✅ Supported

Click - Click on an element
DoubleClick - Double click on an element
Draw - Draw shapes on elements