Предварительная версия Azure Playwright

2025-07-01

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

Готовы приступить к работе? Перейдите к руководству по краткого руководства!

Полезные ссылки

Начать сейчас

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

Предпосылки

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

Создание рабочей области

Войдите в портал Playwright с учетной записью Azure.

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

Создание новой рабочей области

Поле	Описание
Имя рабочей области	Уникальное имя для идентификации рабочей области. Имя не может содержать специальные символы или пробелы.
Подписка на Azure	Выберите подписку Azure, в которой вы хотите создать рабочую область.
Регион	Здесь данные тестового запуска будут храниться для рабочей области.

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

Установка пакета Azure Playwright

Выполните следующую команду, чтобы установить пакет службы
```
npm init @azure/playwright
```

Установка пакета службы создаст файл конфигурации службы с именем playwright.service.config.ts

Конфигурация службы служит для следующих компонентов:

Направляйте и проверяйте подлинность Playwright в службе Azure Playwright.
При необходимости переопределите время ожидания для операций службы.

Убедитесь, что проект использует @playwright/test версии 1.47 или более поздней.

Получение конечной точки региона

На портале Playwrightскопируйте команду в конечную точку региона в настроенном.

URL-адрес конечной точки соответствует региону рабочей области. Вы можете увидеть другой URL-адрес конечной точки на портале Playwright в зависимости от региона, выбранного при создании рабочей области.

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

Убедитесь, что PLAYWRIGHT_SERVICE_URL, полученные на предыдущем шаге, доступны в вашей среде.

Мы рекомендуем использовать модуль dotenv для управления средой. С помощью dotenv вы будете использовать файл .env для определения переменных среды.

Не забудьте добавить .env файл в файл .gitignore, чтобы не утечка секретов.

npm i --save-dev dotenv

Файл .env

PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/accounts/workspace-id/browsers

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

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

Служба предлагает два метода проверки подлинности: идентификатор Microsoft Entra и маркеры доступа.

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

Настройка проверки подлинности с помощью идентификатора Microsoft Entra

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

az login

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

Настройка проверки подлинности с помощью токенов доступа

Вы можете создать маркер доступа из рабочей области Azure Playwright и использовать его в настройке. Однако настоятельно рекомендуется использовать идентификатор Microsoft Entra для проверки подлинности из-за повышенной безопасности. Маркеры доступа, хотя и удобны, действуют как долговременные пароли и более подвержены компрометации.

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

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

ЗАМЕТКА: Чтобы использовать Azure Playwright в конвейерах CI, необходимо настроить проверку подлинности с помощью службы из конвейера, см. раздел Настройка непрерывного сквозного тестирования в разных браузерах и операционных системах

Выполнение тестов

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

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

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

Выполнение тестов в конвейере CI/CD .
Узнайте, как управлять доступом в созданную рабочую область.
Экспериментируйте с разными рабочими ролей, чтобы определить оптимальную конфигурацию набора тестов.

Вклад

Этот проект приветствует взносы и предложения. Большинство вкладов требуют, чтобы вы согласились с соглашением о лицензии участника (CLA), заявив, что у вас есть право, и на самом деле, предоставьте нам права на использование вашего вклада. Для получения подробных сведений посетите веб-страницу https://cla.opensource.microsoft.com.

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

В рамках этого проекта действуют правила поведения в отношении продуктов с открытым исходным кодом Майкрософт. Для получения дополнительной информации см. FAQ о кодексе поведения, или свяжитесь с [email protected] по любым дополнительным вопросам или комментариям.

Товарные знаки

Этот проект может содержать товарные знаки или логотипы для проектов, продуктов или служб. Авторизованное использование товарных знаков или логотипов Майкрософт распространяется и должно соответствовать рекомендациям корпорации Майкрософт по товарным знакам и брендам. Использование товарных знаков майкрософт или логотипов в измененных версиях этого проекта не должно вызывать путаницу или не подразумевать спонсорство Майкрософт. Любое использование сторонних товарных знаков или логотипов распространяется на политики сторонних производителей.