Руководство: Выполнение сквозных тестов Playwright с помощью рабочих пространств Playwright

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

Изучив это руководство, вы:

• Настройте набор тестов Playwright.
• Интегрируйте набор тестов Playwright с рабочими областями Playwright.
• Запустите набор тестов со службой для ускорения выполнения.

Предпосылки

• Учетная запись Azure с активной подпиской. Если у вас нет подписки на Azure, создайте бесплатную учетную запись перед началом.
• Azure CLI, установленный на локальном компьютере.
• Azure CLI версии 2.2.0 или более поздней. Запустите az --version , чтобы проверить установленную версию на компьютере. Если вам нужно установить или обновить Azure CLI, см . инструкции по установке Azure CLI.
• Visual Studio Code. Если у вас его нет, скачайте и установите его.
• Git. Если у вас его нет, скачайте и установите его.

Проверка предварительных условий

Прежде чем начать, проверьте свою среду:

1. Войдите в портал Azure и убедитесь, что ваша подписка активна.

2. Проверьте версию Azure CLI в терминале или в командном окне, выполнив команду az --version. Сведения о последней версии см. в заметках о выпуске.

Если у вас нет последней версии, обновите установку, следуя указаниям в руководстве по установке операционной системы или платформы.

Настройка набора тестов Playwright

На этом шаге вы создаете набор тестов Playwright, интегрированный со службой.

1. Клонируйте пример репозитория и перейдите к тестовой папке.

git clone https://github.com/Azure/playwright-workspaces
cd playwright-workspaces/samples/playwright-tests

2. Установите зависимости.

npm install

3. Запустите тесты Playwright.

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

npx playwright test

Интеграция набора тестов Playwright с рабочими областями Playwright

Интеграция набора тестов Playwright, созданного в предыдущем руководстве, с помощью службы Playwright Workspaces.

Выполните следующие действия, чтобы настроить службу и интегрировать набор тестов.

Создайте рабочую область Playwright

Чтобы приступить к выполнению тестов Playwright в облачных браузерах, сначала необходимо создать рабочую область Playwright.

1. Войдите на портал Azure.

2. Нажмите кнопку меню в левом верхнем углу портала и выберите команду "Создать ресурс ".

   

3. Введите Playwright Workspaces в поле поиска.

4. Выберите карточку «Рабочие пространства драматурга », а затем нажмите кнопку «Создать».

   

5. Предоставьте следующие сведения для настройки нового рабочего пространства Playwright:

   Поле	Описание
   Подписка	Выберите подписку Azure, которую вы хотите использовать для этой рабочей области Playwright.
   Группа ресурсов	Выберите существующую группу ресурсов. Или выберите Create new и введите уникальное имя для новой группы ресурсов.
   Имя	Введите уникальное имя для идентификации рабочей области. Имя может состоять только из буквенно-цифровых символов и иметь длину от 3 до 64 символов.
   Местоположение	Выберите географическое расположение для размещения рабочей области. Это расположение также определяет, где хранятся результаты выполнения теста.

   Замечание

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

6. После того как вы закончите настройку ресурса, выберите Проверить + Создать.

7. Просмотрите все параметры конфигурации и нажмите кнопку Создать , чтобы начать развертывание рабочей области Playwright.

   По завершении процесса появится сообщение об успешном развертывании.

8. Чтобы просмотреть новую рабочую область, выберите Перейти к ресурсу.

   

Установка пакета рабочих пространств Playwright

Чтобы установить пакет службы, перейдите к расположению набора тестов, созданного в предыдущем руководстве, и выполните следующую команду:

npm init @azure/playwright@latest

Эта команда создает playwright.service.config.ts файл, который служит для направления и проверки подлинности Playwright в рабочие пространства Playwright.

Настройка конечной точки региона службы

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

Чтобы получить URL-адрес конечной точки службы, перейдите в рабочую область на портале Azure. Затем в настройке добавьте конечную точку региона, скопируйте конечную точку региона для рабочей области. URL-адрес конечной точки соответствует региону Azure, выбранному при создании рабочей области. Убедитесь, что этот URL-адрес доступен в PLAYWRIGHT_SERVICE_URL переменной среды.

Настройка среды

Чтобы настроить среду, необходимо настроить PLAYWRIGHT_SERVICE_URL переменную среды со значением, полученным на предыдущих шагах.

Мы рекомендуем использовать dotenv модуль для управления средой. При этом dotenvвы определяете .env переменные среды в файле.

1. Добавьте модуль в dotenv проект:

   npm i --save-dev dotenv
   

2. Создайте файл вместе с файлом .envplaywright.config.ts в проекте Playwright:

   PLAYWRIGHT_SERVICE_URL={MY-REGION-ENDPOINT}
   

   Обязательно замените {MY-REGION-ENDPOINT} заполнитель текста значением, скопированным ранее.

Настройка проверки подлинности

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

Идентификатор Microsoft Entra — это идентификатор по умолчанию и рекомендуемая проверка подлинности для службы. Использование Azure CLI для входа

az login

Замечание

Если вы являетесь частью нескольких клиентов Microsoft Entra, убедитесь, что вы входите в клиент, в котором принадлежит ваша рабочая область. Идентификатор клиента можно получить из портал Azure. См. статью "Поиск клиента Microsoft Entra". После получения идентификатора выполните вход с помощью команды az login --tenant <TenantID>

Запускайте тесты в масштабе

Теперь вы подготовили конфигурацию для выполнения тестов Playwright в облаке с помощью рабочих областей Playwright.

Выполнение тестов Playwright с помощью службы

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

Выполните следующие шаги, чтобы запустить тесты Playwright с помощью рабочих пространств Playwright.

1. Откройте окно терминала.

2. Введите следующую команду, чтобы запустить набор тестов Playwright в удаленных браузерах и опубликовать результаты теста в рабочей области.

   npx playwright test --config=playwright.service.config.ts --workers=20
   

   После завершения теста можно просмотреть состояние теста в терминале.

   Running 600 tests using 20 workers
       600 passed (3m)
   

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

• Настройка непрерывного сквозного тестирования в CI/CD
• Изучение параметров конфигурации службы
• Определение оптимальной конфигурации набора тестов