Package io.karatelabs.driver.w3c

Class W3cSession

java.lang.Object

io.karatelabs.driver.w3c.W3cSession

public class W3cSession
extends Object

W3C WebDriver HTTP session client. Uses java.net.http.HttpClient for clean separation from scenario HTTP state.

Implements the W3C WebDriver protocol: W3C WebDriver Specification

Method Summary

Modifier and Type	Method	Description
void	acceptAlert()
void	addCookie(Map<String,Object> cookie)
void	back()
void	clearElement(String elementId)
void	clickElement(String elementId)
void	closeWindow()
static W3cSession	create(String baseUrl, Map<String,Object> sessionPayload, Duration timeout)	Create a new WebDriver session.
void	deleteAllCookies()
void	deleteCookie(String name)
void	deleteSession()
void	dismissAlert()
byte[]	elementScreenshot(String elementId)
Object	executeScript(String script, Object... args)
String	findElement(String using, String value)	Find a single element.
List<String>	findElements(String using, String value)	Find multiple elements.
void	forward()
void	fullscreenWindow()
String	getAlertText()
List<Map<String,Object>>	getAllCookies()
Map<String,Object>	getCookie(String name)
String	getElementAttribute(String elementId, String name)
String	getElementProperty(String elementId, String name)
String	getElementTagName(String elementId)
String	getElementText(String elementId)
String	getSessionId()
String	getTitle()
String	getUrl()
String	getWindowHandle()
List<String>	getWindowHandles()
Map<String,Object>	getWindowRect()
boolean	isElementEnabled(String elementId)
void	maximizeWindow()
void	minimizeWindow()
void	navigateTo(String url)
void	parentFrame()
void	performActions(List<Map<String,Object>> actions)	Perform W3C Actions (keyboard, mouse, pointer).
void	refresh()
void	releaseActions()	Release all actions (reset keyboard/mouse state).
byte[]	screenshot()
void	sendAlertText(String text)
void	sendKeys(String elementId, String text)
void	setWindowRect(Map<String,Object> rect)
void	switchFrame(Object id)
void	switchWindow(String handle)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

create

public static W3cSession create(String baseUrl,
 Map<String,Object> sessionPayload,
 Duration timeout)

Create a new WebDriver session.

Parameters:

baseUrl - WebDriver server URL (e.g., "http://localhost:9515")

sessionPayload - W3C session creation payload

timeout - request timeout

Returns:

a new W3cSession

navigateTo

public void navigateTo(String url)

getUrl

public String getUrl()

getTitle

public String getTitle()

back

public void back()

forward

public void forward()

refresh

public void refresh()

executeScript

public Object executeScript(String script,
 Object... args)

findElement

public String findElement(String using,
 String value)

Find a single element. Returns the W3C element ID.

Throws:

DriverException - if element not found

findElements

public List<String> findElements(String using,
 String value)

Find multiple elements. Returns list of W3C element IDs.

clickElement

public void clickElement(String elementId)

sendKeys

public void sendKeys(String elementId,
 String text)

clearElement

public void clearElement(String elementId)

getElementText

public String getElementText(String elementId)

getElementAttribute

public String getElementAttribute(String elementId,
 String name)

getElementProperty

public String getElementProperty(String elementId,
 String name)

getElementTagName

public String getElementTagName(String elementId)

isElementEnabled

public boolean isElementEnabled(String elementId)

elementScreenshot

public byte[] elementScreenshot(String elementId)

screenshot

public byte[] screenshot()

switchFrame

public void switchFrame(Object id)

parentFrame

public void parentFrame()

getAlertText

public String getAlertText()

acceptAlert

public void acceptAlert()

dismissAlert

public void dismissAlert()

sendAlertText

public void sendAlertText(String text)

getWindowRect

public Map<String,Object> getWindowRect()

setWindowRect

public void setWindowRect(Map<String,Object> rect)

maximizeWindow

public void maximizeWindow()

minimizeWindow

public void minimizeWindow()

fullscreenWindow

public void fullscreenWindow()

getWindowHandle

public String getWindowHandle()

getWindowHandles

public List<String> getWindowHandles()

switchWindow

public void switchWindow(String handle)

closeWindow

public void closeWindow()

getCookie

public Map<String,Object> getCookie(String name)

getAllCookies

public List<Map<String,Object>> getAllCookies()

addCookie

public void addCookie(Map<String,Object> cookie)

deleteCookie

public void deleteCookie(String name)

deleteAllCookies

public void deleteAllCookies()

performActions

public void performActions(List<Map<String,Object>> actions)

Perform W3C Actions (keyboard, mouse, pointer). POST /session/{id}/actions

releaseActions

public void releaseActions()

Release all actions (reset keyboard/mouse state). DELETE /session/{id}/actions

deleteSession

public void deleteSession()

getSessionId

public String getSessionId()