Playwrightium

• Как ставится
• Работает как обычный Webdriver
• Что умеет
• Как использовать с Selenide
• Список всех доступных опций
• Трейсинг

Зачем

Мне нравится Java. Мне нравится Selenium. Мне нравится Selenide. Но также мне нравится Playwright Java. 

Я хочу использовать все (или почти все) возможности Playwright и продолжать использовать синтаксис Selenide. 

Что делать? Я сделал Playwrightium.

Как ставится

Maven 

Добавить в pom.xml.

Добавить зависимость:

<dependency>
    <groupId>io.github.britka</groupId>
    <artifactId>playwrightium</artifactId>
    <version>LAST_VERSION</version>
</dependency>

Gradle

implementation 'io.github.britka:playwrightium:LAST_VERSION'

Эта зависимость инкапсулирует:

• Selenide 
• Playwright Java

Работает как обычный Webdriver

Вы можете использовать его как обычный Webdriver:

WebDriver driver = new PlaywrightiumDriver();
driver.get("https://example.com");
driver.findElement(By.name("username")).sendKeys("Some value");
driver.findElement(By.cssSelector("input[value=submit][name=submitbutton]")).click();

Если нужно больше примеров, прошу, они здесь.

При первом запуске в Playwright будут установлены образы браузеров:

• chromium
• firefox
• webkit (Safari)

После установки тест будет запущен.

Если вы хотите пропустить загрузку одного из браузеров, можно настроить это с помощью PlaywrightiumOptions и укажите Playwrightium использовать локальный браузер.

Пример:

PlaywrightiumOptions playwrightiumOptions = new PlaywrightiumOptions();
playwrightiumOptions.setSkipDownloadBrowsers(true);
playwrightiumOptions.setBrowserName(Browsers.CHROME_CHANNEL);
PlaywrightiumDriver playwrightiumDriver = new PlaywrightiumDriver(playwrightiumOptions);

Что умеет Playwrightium

Переход на URL

driver.get("https://examle.com");

Поиск элементов и коллекций элементов по различным локаторам:

• By.xpath
• By.cssSelector
• By.id
• By.name
• By.linkText
• By.partialLinkText
• By.className
• By.tagName

Например:

WebElement xpathElement = driver.findElement(By.xpath("//label[text()='Some text']"));
WebElement cssElement = driver.findElement(By.xpath("//label[text()='Some text']"));

List<WebElement> elementList = driver.findElements(By.name("any name"));

Также вы можете использовать локаторы Playwright (здесь оф.документация)

Для этого используйте класс PlaywrightiumBy:

• PlaywrightiumBy.byRole
• PlaywrightiumBy.byAltTextbyLabel
• PlaywrightiumBy.byPlaceholder
• PlaywrightiumBy.byTestId
• PlaywrightiumBy.byText
• PlaywrightiumBy.byTitle 

Например:

import org.openqa.selenium.WebElement;

WebElement submitButton = driver.findElement(PlaywrightiumBy.byRole(AriaRole.BUTTON, AriaRoleOptions.builder().setName("submit").build()));
WebElement driver.findElement(PlaywrightiumBy.byLabel("LabeText", true));

Работа с WebElements

Например:

var name = element.getAttribute("name");
element.click();
element.isDisplayed();
element.getText();

Важно! Метод sendKeys работает быстро и плавно. Но метод Selenide setValue может работать медленно. Этот метод делает много полезного. Поэтому, если есть возможность, используйте sendKey из Playwrightium.

Переключаться на фрейм

driver.switchTo().frame("frameName");

Работать с веб-элементом Select

ISelect select = new PlaywrightiumSelect(driver.findElement(By.name("dropdown"))); 
select.selectByValue("dd"+faker.number().numberBetween(1,7));
String selectValue = select.getFirstSelectedOption().getAttribute("value");

Используйте ожидания:

 new WebDriverWait(driver, Duration.ofSeconds(10)).
    until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//h1[contains(.,'Processed Form Details')]")));

Алерты

Но для этого необходимо хорошо знать, как они работают в Playwright.

// At first describe what we want to do with alert
Alert alert = driver.switchTo().alert();
alert.sendKeys(testString);
alert.accept();

// After we do some actions that will lead to alert appearance.
driver.findElement(By.id("promptexample")).click();

// After we can make some checks
assertThat(alert.getText()).isEqualTo("I prompt you");

Класс Actions

new Actions(driver).moveToElement(driver.findElement(By.id("someId"))).build().perform();

Важно. Некоторые функции находятся в стадии разработки. Поэтому я не могу гарантировать, что всё будет работать нормально.

Запускать JS-скрипты

((JavascriptExecutor)driver).executeScript("return alert();");

Захватывать видео

Инициализируйте драйвер Playwrightium с помощью класса PlaywrightiumOptions:

PlaywrightiumOptions playwrightiumOptions = new PlaywrightiumOptions();
playwrightiumOptions.setRecordVideo(true);

driver =new PlaywrightiumDriver(playwrightiumOptions);

Это создаст папку ‘builds/video’ в корне вашего проекта.

или инициализируйте папку с видео:

PlaywrightiumOptions playwrightiumOptions = new PlaywrightiumOptions();
playwrightiumOptions.setRecordVideo(true);
playwrightiumOptions.setRecordsFolder(Path.of("videosFolder"));
driver =new PlaywrightiumDriver(playwrightiumOptions);

Это создаст папку ‘videosFolder‘ в корне вашего проекта.

Если инициализировать драйвер в разделе BeforeAll (или аналогичном), он запишет все тесты в один видеофайл. Чтобы записать видео отдельных тестов, необходимо инициализировать браузер перед каждым тестом.

Этот метод будет работать везде: локально, в Selenoid, Selenium Grid, Aerokube Moon.

Как работает эта функция.

Для браузеров на базе Chromium Playwright пытается использовать протокол CDP для скринкастинга контекста браузера и сбора скриншотов, после чего использует ffmpeg для создания видео из изображений.

Удаленный запуск

Использование Selenoid или Selenium Grid

Это будет работать только с браузерами на основе Chromium (Chromium, Chrome, MS Edge, Opera и т.д.).

Инициализируйте драйвер Playwrightium с помощью класса PlaywrightiumOptions:

PlaywrightiumOptions playwrightiumOptions = new PlaywrightiumOptions();
playwrightiumOptions.setConnectionByWS(false);
playwrightiumOptions.setHeadless(true);
return new PlaywrightiumDriver("http://localhost:4444/wd/hub",chromeOptions);

chromeOptions.setConnectionByWS(false); говорит нам о том, что мы будем использовать http-соединения, как при обычном подключении к Selenoid или Selenium Grid.

Использование Aerokube Moon

Работает со всеми браузерами. 

Инициализируйте драйвер Playwrightium с помощью класса PlaywrightiumOptions:

PlaywrightiumOptions playwrightiumOptions = new PlaywrightiumOptions();
playwrightiumOptions.setConnectionByWS(true);
playwrightiumOptions.setHeadless(true);
return new PlaywrightiumDriver("http://localhost:4444/wd/hub",playwrightiumOptions);

chromeOptions.setConnectionByWS(true); говорит нам о том, что мы будем использовать ws-соединения, как и при обычном подключении к Aerokube Moon.

Как использовать с Selenide

Для этого обходимо реализовать интерфейс WebDriverProvider. Например:

public class PWDriverProvider implements WebDriverProvider {
    @Nonnull
    @Override
    public WebDriver createDriver(@Nonnull Capabilities capabilities) {
        PlaywrightWebdriverOptions playwrightiumOptions = new PlaywrightWebdriverOptions();
        playwrightiumOptions.merge(capabilities);
        return new PlaywrightiumDriver(playwrightiumOptions);
    }
}

Тогда нужно использовать его с Configuration.

Configuration.browser = PWDriverProvider.class.getName();

Список всех доступных опций Playwrightium

Таблица — по ссылке.

Трейсинг

Если тесты были запущены с использованием опции enableTracing, по умолчанию файл tracing.zip должен быть создан в папке {projectRootDirectory}/tracing/. 

Для запуска просмотра трассировки:

viewTracing.sh path/to/your/tracing.zip

Сергей Брит, контрибьютор Selenide

Презентация на Selenium Conf