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

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

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

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

• краткое руководство по . Выполнение комплексных тестов в масштабе
• краткое руководство. Настройка непрерывного сквозного тестирования в разных браузерах и операционных системах
• Изучение функций и преимуществ
• документации
• цен
• Общий доступ к отзыву

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

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

Необходимые условия

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

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

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

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

   

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

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

Установка пакета Microsoft Playwright Testing

1. Выполните следующую команду, чтобы установить пакет службы

   npm init @azure/microsoft-playwright-testing
   

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

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

• Прямая проверка подлинности Playwright в службе тестирования Microsoft Playwright.
• Добавьте отчеты Microsoft Playwright Testing в конфигурацию.
• При необходимости переопределите время ожидания для операций службы.

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

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

1. На портале 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 в рабочей области Microsoft Playwright Testing, необходимо выполнить проверку подлинности клиента 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>

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

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

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

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

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

ПРИМЕЧАНИЕ. Для использования Microsoft Playwright Testing в конвейерах CI необходимо настроить проверку подлинности с помощью службы из конвейера, см. настройке непрерывного сквозного тестирования в разных браузерах и операционных системах

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

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

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

Дальнейшие действия

• Выполнение тестов в конвейере CI/CD .

• Узнайте, как управлять доступом в созданную рабочую область.

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

Способствует

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

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

Этот проект принял Microsoft Open Source Code of Conduct. Дополнительные сведения см. в кодекса поведения или с дополнительными вопросами или комментариями.

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

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