Командная строка
Введение
Ниже приведены наиболее распространенные опции, доступные в командной строке.
-
Запустить все тесты
npx playwright test
-
Запустить один файл тестов
npx playwright test tests/todo-page.spec.ts
-
Запустить набор файлов тестов
npx playwright test tests/todo-page/ tests/landing-page/
-
Запустить файлы, у которых в имени есть
my-specилиmy-spec-2npx playwright test my-spec my-spec-2
-
Запустить тесты, которые находятся на строке 42 в my-spec.ts
npx playwright test my-spec.ts:42
-
Запустить тест с заданным заголовком
npx playwright test -g "add a todo item"
-
Запустить тесты в браузерах с интерфейсом
npx playwright test --headed
-
Запустить все тесты для конкретного проекта
npx playwright test --project=chromium
-
Отключить параллелизацию
npx playwright test --workers=1
-
Выбрать отчетчик
npx playwright test --reporter=dot
-
Запустить в отладочном режиме с Playwright Inspector
npx playwright test --debug
-
Запустить тесты в интерактивном режиме пользовательского интерфейса с встроенным режимом отслеживания (Предварительный просмотр)
npx playwright test --ui
-
Запросить помощь
npx playwright test --help
Справочник
Полный набор опций Playwright Test доступен в файле конфигурации. Следующие опции могут быть переданы в командную строку и имеют приоритет над файлом конфигурации:
| Опция | Описание |
|---|---|
| Аргументы без опций | Каждый аргумент обрабатывается как регулярное выражение, сопоставляемое с полным путем к файлу теста. Будут выполнены только тесты из файлов, соответствующих шаблону. Специальные символы, такие как $ или * должны быть экранированы с помощью \. В многих оболочках/терминалах вам может потребоваться заключить аргументы в кавычки. |
-c <file> или --config <file>
|
Файл конфигурации. Если не указан, по умолчанию используется playwright.config.ts или playwright.config.js в текущей директории. |
--debug |
Запуск тестов с Playwright Inspector. Сокращение для переменной среды PWDEBUG=1 и опций --timeout=0 --max-failures=1 --headed --workers=1 . |
--fail-on-flaky-tests |
Прерывает прогон тестов, содержащих нестабильные тесты. По умолчанию нестабильные тесты считаются успешными. |
--forbid-only |
Разрешить или запретить test.only. Полезно для CI. |
--global-timeout <number> |
Общий таймаут для всего прогона тестов в миллисекундах. По умолчанию глобального таймаута нет. Подробнее о различных таймаутах. |
-g <grep> или --grep <grep>
|
Запуск только тестов, соответствующих этому регулярному выражению. Например, это запустит 'should add to cart' при передаче -g "add to cart". Регулярное выражение будет проверено на строке, состоящей из имени проекта, имени файла теста, test.describe заголовков, если таковые имеются, заголовка теста и всех тегов теста, разделенных пробелами, например, chromium my-test.spec.ts my-suite my-test @smoke. Фильтр не применяется к тестам из зависимых проектов, т.е. Playwright по-прежнему запустит все тесты из зависимых проектов. |
--grep-invert <grep> |
Запуск только тестов, не соответствующих этому регулярному выражению. Обратная операция к --grep. Фильтр не применяется к тестам из зависимых проектов, т.е. Playwright по-прежнему запустит все тесты из зависимых проектов. |
--headed |
Запуск тестов в браузерах с интерфейсом. Полезно для отладки. |
--ignore-snapshots |
Игнорировать снимки. Используйте это, когда ожидаемые результаты снимков отличаются, например, при запуске тестов на Linux по отношению к снимкам Windows. |
--last-failed |
Запуск только тестов, которые завершились ошибкой. |
--list |
Показать список всех тестов, но не запускать их. |
--max-failures <N> или -x
|
Останов после первой N ошибки в тестах. Передача -x останавливает прогон после первой ошибки. |
--no-deps |
Игнорировать зависимости между проектами и вести себя так, как если бы они не были указаны. |
--output <dir> |
Директория для артефактов, созданных тестами, по умолчанию test-results. |
--only-changed [ref] |
Запуск только тех файлов тестов, которые были изменены между рабочей областью и "ref". По умолчанию запускаются все несохраненные изменения с ref=HEAD. Поддерживается только Git. |
--pass-with-no-tests |
Разрешить прогону тестов завершаться успешно, даже если не найдено ни одного файла. |
--project <name> |
Запуск только тестов из указанных проектов, поддерживается символ '*' для подстановки. По умолчанию запускаются все проекты, определенные в файле конфигурации. |
--quiet |
Подавить вывод stdout и stderr из тестов. |
--repeat-each <N> |
Запуск каждого теста N раз, по умолчанию один раз. |
--reporter <reporter> |
Выбрать отчетчик: минималистичный dot, краткий line или подробный list. Смотрите отчетчики для получения дополнительной информации. Также можно указать путь к файлу настраиваемого отчетчика. |
--retries <number> |
Максимальное количество повторных попыток для нестабильных тестов, по умолчанию ноль (без повторных попыток). |
--shard <shard> |
Разделить тесты и выполнить только выбранный фрагмент, указанный в формате current/all, с нумерацией с 1, например 3/5. |
--timeout <number> |
Максимальный таймаут для каждого теста в миллисекундах, по умолчанию 30 секунд. Подробнее о различных таймаутах. |
--trace <mode> |
Принудительно включить режим трассировки, может быть on, off, on-first-retry, on-all-retries, retain-on-failure
|
--tsconfig <path> |
Путь к одному tsconfig, применимому ко всем импортированным файлам. См. разрешение tsconfig для получения дополнительной информации. |
--update-snapshots или -u
|
Обновлять снимки фактическими результатами вместо сравнения. Используйте это, когда ожидаемые результаты снимков изменились. |
--workers <number> или -j <number>
|
Максимальное количество одновременных процессов-работников, выполняемых параллельно. |
© 2024 Microsoft
Licensed under the Apache License, Version 2.0.
https://playwright.dev/docs/test-cli