Skip to content

Custom commands

Jump to bottom
Ondřej Machulda edited this page Apr 16, 2021 · 4 revisions

Since version 1.8.0, php-webdriver allows sending custom commands to the remote end.

This is useful for eg. vendor-specific commands, which are not part of the W3C WebDriver standard and are only available in specific browsers, or for commands which were not yet implemented in this library.

$driver = RemoteWebDriver::create($host, $capabilities);

// Execute Mozilla vendor-specific print command
$driver->executeCustomCommand(
    '/session/:sessionId/moz/print/', 
    'POST'
);

// Execute Mozilla vendor-specific full-page screenshot command
$screenshot = $driver->executeCustomCommand(
    '/session/:sessionId/moz/screenshot/full/',
    'POST'
);
file_put_contents('full.png', base64_decode($screenshot));

// Execute Appium command to get content of the system clipboard
$clipboard = $driver->executeCustomCommand(
    '/session/:sessionId/appium/device/get_clipboard/',
    'POST'
);

// Execute ChromeDevTools protocol command
$result = $driver->executeCustomCommand(
    '/session/:sessionId/goog/cdp/execute',
    'POST',
    ['cmd' => 'Runtime.evaluate', 'params' => ['expression' => 'window.location.toString()']]
);
Clone this wiki locally