Как управлять браузером через Playwright на Python: форма, клик и скриншот

Playwright позволяет Python управлять настоящим браузером и одновременно проверять, что пользовательский сценарий завершился правильно. Вместо движения мыши по координатам скрипт находит поле по подписи, кнопку по роли, ждёт результат и сохраняет скриншот. Соберём такой сценарий на локальной странице, чтобы сеть и чужой сайт не мешали понять механику.

Автоматизация браузера часто выглядит как магия: окно само открывается, текст появляется в форме, кнопка нажимается без человека. На деле здесь есть точная цепочка. Python запускает движок Chromium, Playwright создаёт страницу, локаторы находят элементы по смыслу, а ожидания синхронизируют действия с интерфейсом.

Как Playwright видит страницу и действия

Проект состоит из двух файлов. demo.html является маленьким приложением: в нём есть связанная с полем подпись, кнопка и область результата с data-testid. main.py запускает Playwright в синхронном режиме и открывает HTML через file URL. Затем сценарий выполняет ровно те действия, которые сделал бы человек.

У проекта есть один главный маршрут: получить входные данные, проверить их, выполнить действие и показать результат. Если каждый этап можно проверить отдельно, ошибка перестаёт быть загадкой.

От входных данных до видимого результата. Сначала действие, затем ожидание и доказательство

Пишем форму и первый Python-сценарий

Создайте каталог и выполните uv init browser-lab, затем uv add playwright и uv run playwright install chromium. Последняя команда загружает совместимый браузер. Положите рядом demo.html из исходников статьи и main.py. Запускайте через uv run python main.py. Значение headless=False оставляет окно видимым; когда сценарий станет стабильным, поменяйте его на True для фонового запуска.

from pathlib import Path
from playwright.sync_api import expect, sync_playwright

page_url = Path("demo.html").resolve().as_uri()

with sync_playwright() as playwright:
    browser = playwright.chromium.launch(headless=False)
    page = browser.new_page(viewport={"width": 1100, "height": 720})

    page.goto(page_url)
    page.get_by_label("Имя").fill("Аня")
    page.get_by_role("button", name="Проверить").click()

    result = page.get_by_test_id("result")
    expect(result).to_have_text("Привет, Аня!")
    page.screenshot(path="result.png", full_page=True)

    print("Готово: приветствие проверено, result.png сохранён")
    browser.close()

Сценарий не содержит sleep и координат. Playwright сам ждёт, пока поле станет доступным, кнопка перестанет двигаться и элемент сможет принять действие. Это делает тест быстрее на хорошем компьютере и устойчивее на медленном.

Что отличает устойчивый проект от случайного успеха. Хороший локатор описывает назначение, а не положение

Почему локаторы надёжнее координат

Локатор не является найденным DOM-элементом, сохранённым навсегда. Это описание того, как Playwright должен найти элемент в момент действия. get_by_label связывает текст подписи с input через атрибут for, get_by_role использует доступную роль button и имя, а get_by_test_id обращается к стабильному служебному атрибуту.

CSS-селектор вроде div:nth-child(3) привязан к форме страницы, а роль и подпись описывают назначение элемента. Если дизайнер добавит обёртку, семантический локатор продолжит работать. Если на странице две одинаковые кнопки, Playwright специально сообщит о неоднозначности.

Ломаем сценарий и учимся читать ошибку

Запустите готовый сценарий, затем намеренно замените ожидаемое имя на «Борис». Посмотрите, как expect показывает полученный и ожидаемый текст. Верните правильное значение и удалите атрибут for у label в demo.html: теперь get_by_label не должен находить поле. Исправьте связь. После этого добавьте чекбокс «Писать официально» и второй вариант ответа.

Главный результат этой практики не скриншот, а воспроизводимый сценарий. Он либо подтверждает нужное состояние, либо останавливается в точной строке. Теперь браузерная автоматизация стала проверкой, а не записью движений мыши.

Четыре проверки перед следующим шагом. Падение должно объяснять, какой шаг не выполнен

Куда развивать браузерную автоматизацию

Следующий шаг зависит от задачи. Для тестирования оформите сценарий как pytest-тест и создавайте новую страницу для каждого случая. Для рутинной автоматизации добавьте входные данные из JSON и отчёт, но не храните пароли в коде. Секреты передавайте через переменные окружения, а чувствительные поля маскируйте на скриншотах.

Как изучить тему в Кодике

В Кодике начните с функций, путей к файлам и контекстных менеджеров Python. Затем закрепите HTML-формы и события на простом примере. После этого API Playwright читается естественно: объект page получает команды, локатор описывает элемент, а expect проверяет состояние.

После статьи повторите только demo.html и первые четыре действия main.py в тренажёре Кодика. На следующий день соберите их по памяти и добавьте второй сценарий. Так вы учите не список методов, а модель: найти элемент, выполнить действие, дождаться состояния, доказать результат.

Что получится в итоге

Python открывает локальную форму, вводит имя, проверяет приветствие и сохраняет PNG только после успешного сценария.