Skip to main content

Командная строка

Введение​

Здесь представлены наиболее распространенные опции, доступные в командной строке.

  • Запуск всех тестов

    npx playwright test

  • Запуск одного файла теста

    npx playwright test tests/todo-page.spec.ts

  • Запуск набора файлов тестов

    npx playwright test tests/todo-page/ tests/landing-page/

  • Запуск файлов, в названии которых есть my-spec или my-spec-2

    npx 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

  • Запуск тестов в интерактивном режиме UI с встроенным режимом наблюдения (Предварительный просмотр)

    npx playwright test --ui

  • Запрос помощи

    npx playwright test --help

Справочник​

Полный набор опций Playwright Test доступен в файле конфигурации. Следующие опции могут быть переданы в командную строку и имеют приоритет над файлом конфигурации:

ОпцияОписание
Аргументы без опцийКаждый аргумент рассматривается как регулярное выражение, сопоставляемое с полным путем к файлу теста. Будут выполнены только тесты из файлов, соответствующих шаблону. Специальные символы, такие как $ или *, должны быть экранированы с помощью \. Во многих оболочках/терминалах может потребоваться заключить аргументы в кавычки.
-c <file> или --config <file>Файл конфигурации или директория тестов с необязательным "playwright.config.{m,c}?{js,ts}". По умолчанию используется playwright.config.ts или playwright.config.js в текущей директории.
--debugЗапуск тестов с Playwright Inspector. Сокращение для переменной окружения PWDEBUG=1 и опций --timeout=0 --max-failures=1 --headed --workers=1.
--fail-on-flaky-testsЗавершить с ошибкой, если какой-либо тест помечен как нестабильный (по умолчанию: false).
--forbid-onlyЗавершить с ошибкой, если вызван test.only (по умолчанию: false). Полезно в CI.
--fully-parallelЗапуск всех тестов параллельно (по умолчанию: false).
--global-timeout <timeout>Максимальное время выполнения этого набора тестов в миллисекундах (по умолчанию: неограниченно).
-g <grep> или --grep <grep>Запуск только тестов, соответствующих этому регулярному выражению (по умолчанию: ".*").
-gv <grep> или --grep-invert <grep>Запуск только тестов, не соответствующих этому регулярному выражению.
--headedЗапуск тестов в браузерах с интерфейсом (по умолчанию: без интерфейса).
--ignore-snapshotsИгнорировать ожидания скриншотов и снимков.
--last-failedПовторный запуск только неудачных тестов.
--listСобрать все тесты и сообщить о них, но не запускать.
--max-failures <N> или -xОстановиться после первых N неудач. Передача -x останавливается после первой неудачи.
--no-depsНе запускать зависимости проекта.
--output <dir>Папка для артефактов вывода (по умолчанию: "test-results").
--only-changed [ref]Запускать только те файлы тестов, которые были изменены между 'HEAD' и 'ref'. По умолчанию запускаются все незафиксированные изменения. Поддерживает только Git.
--pass-with-no-testsУспешное завершение тестов, даже если тесты не найдены.
--project <project-name...>Запускать только тесты из указанного списка проектов, поддерживает '*' подстановочный знак (по умолчанию: запуск всех проектов).
--quietПодавить вывод в стандартный поток.
--repeat-each <N>Запуск каждого теста N раз (по умолчанию: 1).
--reporter <reporter>Репортер для использования, через запятую, может быть "dot", "line", "list" или другие (по умолчанию: "list"). Вы также можете передать путь к файлу пользовательского репортера.
--retries <retries>Максимальное количество повторных попыток для нестабильных тестов, ноль для отсутствия повторных попыток (по умолчанию: без повторных попыток).
--shard <shard>Разделить тесты и выполнить только выбранный шард, указанный в формате "current/all", начиная с 1, например, "3/5".
--timeout <timeout>Указать порог времени выполнения теста в миллисекундах, ноль для неограниченного времени (по умолчанию: 30 секунд).
--trace <mode>Принудительный режим трассировки, может быть "on", "off", "on-first-retry", "on-all-retries", "retain-on-failure", "retain-on-first-failure".
--tsconfig <path>Путь к единственному tsconfig, применимому ко всем импортированным файлам (по умолчанию: искать tsconfig для каждого импортированного файла отдельно).
--uiЗапуск тестов в интерактивном режиме UI.
--ui-host <host>Хост для обслуживания UI; указание этой опции открывает UI во вкладке браузера.
--ui-port <port>Порт для обслуживания UI, 0 для любого свободного порта; указание этой опции открывает UI во вкладке браузера.
-u или --update-snapshots [mode]Обновление снимков с фактическими результатами. Возможные значения: "all", "changed", "missing" и "none". Запуск тестов без флага по умолчанию "missing"; запуск тестов с флагом, но без значения по умолчанию "changed".
--update-source-method [mode]Обновление снимков с фактическими результатами. Возможные значения: "patch" (по умолчанию), "3way" и "overwrite". "Patch" создает унифицированный файл diff, который можно использовать для обновления исходного кода позже. "3way" генерирует маркеры конфликтов слияния в исходном коде. "Overwrite" перезаписывает исходный код новыми значениями снимков.
-j <workers> или --workers <workers>Количество параллельных рабочих процессов или процент логических ядер процессора, используйте 1 для запуска в одном рабочем процессе (по умолчанию: 50%).
-xОстановиться после первой неудачи.