Для начала работы с Playwright в проекте необходимо установить его в качестве зависимости через npm. Playwright предоставляет все необходимые инструменты для создания и выполнения тестов, а также для взаимодействия с браузерами на разных платформах.
Для того чтобы установить Playwright, нужно иметь установленный Node.js и npm. В большинстве случаев, последние версии Node.js уже включают npm, так что его нужно проверять лишь в случае, если система не настроена.
Откройте терминал или командную строку.
Перейдите в директорию вашего проекта, где вы хотите установить Playwright. Если проект еще не создан, создайте его с помощью команды:
mkdir my-project
cd my-project
npm init -y
Это создаст базовый package.json файл.
Установите Playwright с помощью команды:
npm install playwright
Эта команда загрузит последнюю стабильную версию Playwright и добавит её в раздел зависимостей вашего проекта.
Playwright поддерживает несколько браузеров, включая Chromium, Firefox и WebKit. По умолчанию, при установке Playwright, скачиваются все три браузера, но если необходимо установить только один или два браузера, можно использовать специализированную команду:
Для установки только Chromium:
npm install playwright-chromiumДля установки только Firefox:
npm install playwright-firefoxДля установки только WebKit:
npm install playwright-webkitОднако для большинства случаев рекомендуется устанавливать все браузеры, чтобы иметь возможность тестировать приложения на разных движках.
Иногда для работы с Playwright может потребоваться дополнительные
зависимости, например, для поддержки определённых функций на платформе.
Если необходимо установить Playwright с дополнительными библиотеками для
работы с браузерами, используйте флаг --extra:
npm install playwright --save-dev --extra
После завершения установки можно проверить, что Playwright был корректно установлен, выполнив следующую команду:
npx playwright --version
Она выведет версию установленного Playwright, что подтвердит успешную установку.
Если проект предполагает использование Playwright в рамках CI/CD пайплайнов (например, Jenkins, GitLab CI или GitHub Actions), рекомендуется установить Playwright в качестве dev-зависимости:
npm install playwright --save-dev
При этом не нужно устанавливать браузеры отдельно, поскольку Playwright будет автоматически загружать их при первом запуске тестов.
В некоторых случаях, в зависимости от версии Node.js или других установленных библиотек, может возникнуть необходимость использовать конкретную версию Playwright. В таком случае можно указать версию при установке:
npm install playwright@1.16.0
Это позволит избежать несовместимости с другими библиотеками или версиями Node.js.
В дополнение к базовому функционалу Playwright предоставляет
расширения для работы с различными браузерами. Это позволяет
разработчикам и тестировщикам гибко настраивать свои среды и
адаптировать Playwright под специфические нужды. Использование таких
расширений и дополнительных пакетов, как playwright-test
для написания тестов, может быть полезно в крупных проектах.
Для добавления пакета playwright-test выполните:
npm install @playwright/test
Этот пакет содержит полезные инструменты для создания и выполнения тестов, таких как асинхронные действия и утверждения.
Установка Playwright через npm — это простой и прямой процесс, который позволяет быстро интегрировать Playwright в проект и начать использовать его для тестирования. Важно учитывать возможность выбора нужных браузеров, а также дополнительные пакеты и библиотеки, которые могут улучшить и ускорить тестирование.