Playwright Backend

SHAFT can run GUI tests through Microsoft Playwright while keeping the same high-level SHAFT browser, element, alert, and assertion entry points.

PlaywrightTest.java
import com.shaft.driver.SHAFT;

public class PlaywrightTest {
    private SHAFT.GUI.Driver driver;

    @BeforeMethod
    public void openBrowser() {
        driver = new SHAFT.GUI.Playwright();
    }

    @Test
    public void search() {
        driver.browser().navigateToURL("https://example.com");
        driver.assertThat().browser().title().contains("Example");
    }

    @AfterMethod(alwaysRun = true)
    public void closeBrowser() {
        driver.quit();
    }
}

Use SHAFT.GUI.WebDriver for the Selenium/Appium backend and SHAFT.GUI.Playwright for the Playwright backend. Both implement SHAFT.GUI.Driver, so test classes can choose the backend at setup time.

Configuration

Common browser settings continue to use the existing web properties:

targetBrowserName
headlessExecution
baseURL
browserWindowWidth
browserWindowHeight
mobile emulation viewport and user-agent settings

Playwright-specific properties use the playwright. prefix:

playwright.browserName: optional override for the Playwright browser engine.
playwright.deviceName: optional Playwright device descriptor for the browser context.
playwright.connectionMode: local, connect, or connectOverCDP.
playwright.endpoint: WebSocket or CDP endpoint for remote Playwright sessions.
playwright.channel: optional Chromium channel.
playwright.slowMo: Playwright slow motion in milliseconds.
playwright.defaultTimeoutMilliseconds
playwright.navigationTimeoutMilliseconds
playwright.artifactsDirectory
playwright.downloadsDirectory
playwright.acceptDownloads
playwright.tracing.enabled
playwright.tracing.onRetryOnly
playwright.tracing.screenshots
playwright.tracing.snapshots
playwright.tracing.sources

playwright.deviceName accepts names from Microsoft Playwright's device descriptor registry. SHAFT reads that registry when creating the context and also provides current-device aliases for Galaxy S26 Ultra and iPhone 17 Pro Max. When playwright.browserName is empty, SHAFT uses the descriptor's default browser type; an explicit playwright.browserName still wins.

Tracing is disabled by default. When SHAFT retry evidence capture is enabled, playwright.tracing.onRetryOnly=true enables tracing for the retry attempt and attaches the resulting Playwright trace zip to the SHAFT report.

Native Access

NativePlaywright.java
SHAFT.GUI.Playwright driver = new SHAFT.GUI.Playwright();

com.microsoft.playwright.Page page = driver.getDriver();
com.microsoft.playwright.BrowserContext context = driver.getNativeContext();
com.microsoft.playwright.Playwright playwright = driver.getPlaywright();

Element actions accept SHAFT locators and concrete Playwright actions also accept native com.microsoft.playwright.Locator objects.

NativeLocator.java
SHAFT.GUI.Playwright driver = new SHAFT.GUI.Playwright();

var saveButton = driver.getDriver().getByRole(
        com.microsoft.playwright.options.AriaRole.BUTTON,
        new com.microsoft.playwright.Page.GetByRoleOptions().setName("Save"));

driver.element().click(saveButton);
driver.assertThat().element(saveButton).isVisible();

The SHAFT locator builder keeps build() for Selenium and adds Playwright support:

PortableLocator.java
var shaftLocator = SHAFT.GUI.Locator.hasTagName("button").hasText("Save").buildPortable();
var playwrightLocator = SHAFT.GUI.Locator.hasTagName("button").hasText("Save")
        .buildForPlaywright(driver.getDriver());

Mapping Tree

Legend:

Supported: implemented for Playwright.
Native: available through a native Playwright overload or native context.
WebDriver-only: intentionally remains on Selenium/Appium because the feature depends on Selenium, Appium, CDP wrappers, Lighthouse, or axe integration.

Driver

WebDriver entry point	Playwright mapping
`new SHAFT.GUI.WebDriver()`	`new SHAFT.GUI.Playwright()`
`quit()`	Supported; closes page, context, browser, Playwright runtime, and trace
`browser()`	Supported: `com.shaft.gui.playwright.browser.BrowserActions`
`element()`	Supported: `com.shaft.gui.playwright.element.ElementActions`
`alert()`	Supported through Playwright dialog event bridge
`assertThat()` / `verifyThat()`	Supported through SHAFT validations
`getDriver()`	Supported; returns native `Page`
WebDriver native object	`getNativeContext()` returns `BrowserContext`; `getPlaywright()` returns runtime
`touch()`	WebDriver-only/Appium-only
`async()`	WebDriver-only
`act(...)` natural GUI actions	WebDriver-only in the first Playwright backend

Browser Actions

WebDriver browser action	Playwright mapping
`navigateToURL(url)`	Supported: `Page.navigate`
`navigateToURL(url, WindowType)`	Supported: new Playwright page
`navigateToURL(url, expectedUrl)`	Supported: navigate then wait for URL
`navigateToURLWithBasicAuthentication(...)`	Supported by embedding credentials in URL
`navigateBack()` / `navigateForward()`	Supported
`refreshCurrentPage()`	Supported
`closeCurrentWindow()`	Supported; closes current page
`maximizeWindow()` / `setWindowSize(w,h)` / `fullScreenWindow()`	Supported as viewport size
`getCurrentURL()` / `getCurrentWindowTitle()` / `getPageSource()`	Supported
`getWindowHandle()` / `getWindowHandles()`	Supported as page URL handles
`switchToWindow(nameOrHandle)`	Supported by URL, title, or index
`getWindowPosition()`	Supported as fixed `0,0` viewport origin
`getWindowSize()` / `getWindowWidth()` / `getWindowHeight()`	Supported from viewport
`addCookie()` / `getCookie()` / `getAllCookies()` / cookie getters	Supported through `BrowserContext.cookies()`
`deleteCookie()` / `deleteAllCookies()`	Supported
`captureScreenshot()` / `captureScreenshot(type)`	Supported; attached to SHAFT report
`capturePageSnapshot()` / `captureSnapshot()`	Supported as HTML attachment
`waitForLazyLoading()`	Supported through Playwright load state
`getContext()` / `setContext()` / `getContextHandles()`	Supported for the Playwright page context
`mock()` / `intercept()` / `interceptRequest()` / `clearNetworkInterceptors()`	WebDriver-only for SHAFT's Selenium HTTP contract; use native Playwright routing from `getDriver()`
`generateLightHouseReport()`	WebDriver-only
`accessibility()`	WebDriver-only axe integration

Element Actions

WebDriver element action	Playwright mapping
`click()`	Supported
`clickUsingJavascript()`	Supported with element JS evaluation
`hover()` / `hoverAndClick()`	Supported
`doubleClick()`	Supported
`clickAndHold()`	Supported with Playwright mouse
`dragAndDrop()` / `dragAndDropByOffset()`	Supported
`type()` / `typeAppend()` / `typeSecure()` / `clear()`	Supported
`typeFileLocationForUpload()` / file drop upload	Supported for input file locators
`select()`	Supported
`setValueUsingJavaScript()` / `submitFormUsingJavaScript()`	Supported
`scrollToElement()`	Supported
`captureScreenshot()`	Supported and attached to report
`getElementsCount()`	Supported
`getTableRowsData()`	Supported
`switchToIframe()` / `switchToDefaultContent()` / `getCurrentFrame()`	WebDriver-style frame switching is WebDriver-only; use native Playwright frame locators
`executeNativeMobileCommand()`	WebDriver-only/Appium-only
Clipboard helpers	WebDriver-only in the first Playwright backend

Assertions And Verifications

WebDriver assertion surface	Playwright mapping
Driver `assertThat().browser()` / `verifyThat().browser()`	Supported through SHAFT validations
Browser `url()` / `title()` / `text()` / `attribute(name)`	Supported
Driver `assertThat().element(locator)` / `verifyThat().element(locator)`	Supported for SHAFT locators and native Playwright locators
Element `exists()` / `doesNotExist()`	Supported
Element `attribute()` / `domAttribute()` / `domProperty()` / `property()`	Supported
Element `text()` / `textTrimmed()` / `cssProperty()`	Supported
Element state checks: selected, checked, visible, enabled, hidden, disabled	Supported
Element visual reference assertions	WebDriver-only in the first Playwright backend
Standalone object/file/number/API assertions	Unchanged

Configuration​

Native Access​

Mapping Tree​

Driver​

Browser Actions​

Element Actions​

Assertions And Verifications​

Related​