Упражнение: Использование Playwright в Visual Studio Code

Завершено

В предыдущем разделе описаны основные понятия, связанные с конфигурацией тестов playwright и спецификацией тестирования playwright, но мы использовали командную строку playwright (CLI) для выполнения наших тестов и просмотра отчетов.

Что делать, если бы мы могли сделать это в нашей среде Visual Studio Code и иметь более визуальный процесс взаимодействия для разработки, запуска и отладки, наших тестов?

С помощью расширения Playwright Test for Visual Studio Code вы получите превосходный интерфейс разработчика и уникальные инструменты, которые могут сделать его предпочитаемым способом взаимодействия со средством выполнения тестов Playwright. Давайте начнем и ознакомимся.

Начало работы

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

Иллюстрация playwright и Visual Studio Code логотипов рядом с заголовком видео о начале работы.

Установка расширения Playwright

Установите расширение из Visual Studio Code Marketplace. После установки вы увидите значок колбы в левой части окна Visual Studio Code, как показано на снимке экрана. Обратите внимание, как расширение автоматически обнаруживает и собирает спецификации тестирования в проекте.

Снимок экрана: обозреватель тестов Visual Studio Code, в котором перечислены тестовые файлы Playwright и тестовые случаи.

На боковой панели Playwright просмотрите проекты, выбранные для выполнения. Выберите только chromium для этой инструкции. Чтобы повторить тест в других настроенных браузерах, выберите также соответствующие проекты и снова запустите тест.

Note

Выбор нового расширения выбирает первый настроенный проект, а последующие сеансы могут сохранять выбранные варианты. VS Code обрабатывает включенные проекты. Это может отличаться от npx playwright test, который запускает все настроенные проекты, если вы не фильтруете выполнение.

Запуск теста (в безголовом режиме)

Оставьте флажок «Показать браузер» снятым, чтобы запуск выполнялся с безголовым режимом по умолчанию из примера конфигурации. Оставьте флажок Показать окно просмотра трассировки снятым при этом первом запуске, чтобы сосредоточиться на результатах теста. Трассировки также можно собирать, пока тестовый браузер работает в безголовом режиме.

Нажмите зеленую кнопку воспроизведения рядом с has title тестом в файле example.spec.ts , чтобы запустить первый тест. Вы также можете выбрать серые кнопки воспроизведения на боковой панели обозревателя тестов, чтобы выполнить все тесты в файле или запустить определенный тест.

Снимок экрана: запуск теста playwright без головы в Visual Studio Code.

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

Снимок экрана: журнал выполнения теста Playwright в Visual Studio Code.

Отображение браузера (с заголовком)

Если вы хотите запустить в режиме управления , то есть запустить тесты с открытым окном браузера, установите флажок "Показать браузер " перед выполнением тестов.

Снимок экрана: видимый браузер, на котором выполняется тест Playwright из Visual Studio Code.

Playwright — это очень быстрый пользователь, который может затруднить отслеживание того, что происходит в тесте при использовании браузера Show. Для отладки рекомендуется использовать параметр "Показать средство просмотра трассировки ".

Проверьте выполнение в Trace Viewer

Выберите Показать средство просмотра трассировки, а затем запустите get started link тест. Расширение открывает средство просмотра трассировки для проверки записанных действий и моментальных снимков страниц. Это не браузер рабочего теста. В текущем расширении включение Показать средство просмотра трассировки отключает Показать браузер, а включение Показать браузер отключает Показать средство просмотра трассировки.

В верхней части окна отобразится временная шкала теста, на которую можно навести указатель мыши, чтобы просмотреть состояние браузера. Чтобы выбрать определенный диапазон времени для фокусировки, выберите и перетащите временную шкалу.

Снимок экрана: временная шкала средства просмотра трассировки Playwright с моментальными снимками состояния браузера.

На левой боковой панели можно увидеть действия, выполненные во время выполнения теста. Если выбрать действие locator.click , вы увидите красную точку на кнопке "Начало работы " в моментальном снимке DOM.

Снимок экрана: выбранное действие щелчка и его цель в моментальном снимке трассировки DOM.

Затем выберите утверждение expect.toBeVisible , и вы увидите, что наш моментальный снимок DOM изменен, чтобы отобразить страницу установки с выделением заголовка, который мы утверждаем. Над моментальным снимком DOM можно выбрать кнопки "До " и " После ", чтобы увидеть состояние DOM до и после выполнения действия.

Снимок экрана: утверждение видимости с выделением заголовка установки в средстве просмотра трассировки Playwright.

Вы можете открыть снимок DOM в отдельном окне, выбрав значок открытия в правом верхнем углу. Это может быть полезно, если вы хотите проверить DOM во время отладки теста.

Снимок экрана: моментальный снимок трассировки DOM, открытый в отдельном окне для проверки.

Говоря об отладке, вы также можете выбрать локатор из моментального снимка DOM, нажав кнопку «Выбрать локатор» на нижней панели. Затем наведите указатель мыши на элементы в снимке DOM, чтобы увидеть локатор для этого элемента. При выборе элемента он добавляется в поле Локатор в нижней части средства просмотра трассы, где его можно отредактировать перед копированием в буфер обмена.

Снимок экрана инструмента Pick Locator при выборе элемента на снимке DOM трассировки Playwright.

Вы можете самостоятельно изучить остальные функции средства просмотра трассировки, такие, как вкладки вызов, консоль, сеть и исходники.

Отладка тестов

Для отладки рекомендуется запускать тесты с опцией "Показать просмотрщик трассировки" и использовать трассу вашего теста, чтобы лучше понять, что происходит.

Однако с расширением Visual Studio Code можно также выполнять отладку тестов прямо в Visual Studio Code, просматривать сообщения об ошибках, создавать точки останова и выполнять отладку тестов в реальном времени. Узнайте больше из документации или просмотрите следующее видео, чтобы получить представление о поддержке отладки.

Иллюстрация миниатюры видео о создании теста Playwright с выступающим и заголовком расширения Visual Studio Code.

Создание тестов

CodeGen создает тесты для вас при выполнении действий в браузере, что делает его самым простым способом начать разработку тестов для сложных рабочих процессов.

Чтобы создать тест, нажмите кнопку "Записать новую" на боковой панели тестирования в Visual Studio Code. Откроется окно браузера, в котором можно выполнить действия, которые будут записаны и преобразованы в тест. Вы также заметите, что новый файл в папке tests создается с помощью созданного теста.

Снимок экрана: создание тестового файла Playwright в Visual Studio Code.

Введите URL-адрес в окне браузера и начните выполнять такие действия, как пользователь. Вы увидите действия, записанные в тестовом файле в VS Code.

Давайте воспроизведем простой тест, который мы провели ранее, перейдя на веб-сайт Playwright и нажав кнопку Начало работы. Затем можно выбрать значок «Проверка видимости» на панели инструментов Codegen и выбрать заголовок Установка, чтобы подтвердить, что он виден.

Снимок экрана: Playwright Codegen, записывающий утверждение видимости для заголовка установки.

Завершите запись и запустите новый тест:

  1. Закройте окно браузера записи, чтобы завершить сеанс записи. Вернитесь к созданному тестовому файлу в Visual Studio Code.
  2. Присвойте созданному тесту описательное название, например recorded get started link. Убедитесь, что он переходит к https://playwright.dev/, выбирает Get started и включает ожидаемую проверку видимости заголовка Installation. Сохраните файл.
  3. Оставьте выбранным только проект на боковой панели chromium Playwright. Запустите новый тест, нажав кнопку воспроизведения, а не запуская всю коллекцию файлов.
  4. Убедитесь, что у нового теста есть один успешный прогон. Если это не удается, проверьте сообщение об ошибке или трассировку и уточните созданный локатор или ассерт перед продолжением.

Note

Оставьте example.spec.ts без изменений при записи нового теста. Если вы добавите ровно один записанный тест, проект теперь имеет три тестовых случая. Выполнение всех тестов только с выбранным Chromium приводит к трем запускам. Запуск CLI без фильтрации со всеми четырьмя настроенными проектами дает двенадцать запусков. Выполнение только нового теста в Chromium по-прежнему дает одно выполнение.

Дополнительные сведения о создании тестов см. в следующем видео.

Иллюстрация карточки заголовка вводного видео с логотипами Playwright и Visual Studio Code.

Дальнейшие шаги

Вы узнали, как найти и запустить тесты в Visual Studio Code, проверить записанные действия в средстве просмотра трассировки и создать тест с помощью Record new. Затем выполните оценку модуля и просмотрите сводку.