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

Playwright предоставляет мощный интерфейс командной строки для запуска тестов, генерации кода, отладки и многого другого. Самый актуальный список доступных в CLI команд и аргументов всегда можно получить с помощью npx playwright --help.

Основные команды​

Запуск тестов​

Запустите тесты Playwright. Подробнее о запуске тестов.

Синтаксис​

npx playwright test [options] [test-filter...]

Примеры​

# Run all tests
npx playwright test

# Run a single test file
npx playwright test tests/todo-page.spec.ts

# Run a set of test files
npx playwright test tests/todo-page/ tests/landing-page/

# Run tests at a specific line
npx playwright test my-spec.ts:42

# Run tests by title
npx playwright test -g "add a todo item"

# Run tests in headed browsers
npx playwright test --headed

# Run tests for a specific project
npx playwright test --project=chromium

# Get help
npx playwright test --help

Отключение параллельного выполнения

npx playwright test --workers=1

Запуск в режиме отладки с помощью Playwright Inspector

npx playwright test --debug

Запуск тестов в интерактивном режиме пользовательского интерфейса

npx playwright test --ui

Общие параметры​

Все параметры​

Список тестов​

Параметры --test-list и --test-list-invert принимают путь к файлу со списком тестов. В этом файле тесты должны быть перечислены в формате, аналогичном выводу в режиме --list.

# This is a test list file.
# It can include comments and empty lines.

# Run ALL tests in a file:
path/to/example.spec.ts

# Run all tests in a file for a specific project:
[chromium] › path/to/example.spec.ts

# Run all tests in a specific group/suite:
path/to/example.spec.ts › suite name

# Run all tests in a nested group:
path/to/example.spec.ts › outer suite › inner suite

# Fully qualified test with a project:
[chromium] › path/to/example.spec.ts:3:9 › suite › nested suite › example test

# This test is included for all projects:
path/to/example.spec.ts:3:9 › example test

# Use "›" or ">" as a separator:
[firefox] > example.spec.ts > suite > nested suite > example test

# Line/column numbers are completely ignored, you can omit them.
# Three entries below refer to the same test:
example.spec.ts › example test
example.spec.ts:15 › example test
example.spec.ts:42:42 › example test

Просмотр отчета​

Показать HTML-отчет о предыдущем запуске тестов. Подробнее об HTML-репортере.

Синтаксис​

npx playwright show-report [report] [options]

Примеры​

# Show latest test report
npx playwright show-report

# Show a specific report
npx playwright show-report playwright-report/

# Show report on custom port
npx playwright show-report --port 8080

Параметры​

Установка браузеров​

Установить браузеры, необходимые для Playwright. Подробнее о поддержке браузеров в Playwright.

Синтаксис​

npx playwright install [options] [browser...]
npx playwright install-deps [options] [browser...]
npx playwright uninstall

Примеры​

# Install all browsers
npx playwright install

# Install only Chromium
npx playwright install chromium

# Install specific browsers
npx playwright install chromium webkit

# Install browsers with dependencies
npx playwright install --with-deps

Параметры установки​

Параметры установки зависимостей​

Инструменты генерации и отладки​

Генерация кода​

Записывать действия и генерировать тесты на разных языках. Подробнее о Codegen.

Синтаксис​

npx playwright codegen [options] [url]

Примеры​

# Start recording with interactive UI
npx playwright codegen

# Record on specific site
npx playwright codegen https://playwright.dev

# Generate Python code
npx playwright codegen --target=python

Параметры​

Просмотр трассировки​

Анализировать и просматривать трассировки тестов для отладки. Подробнее о просмотре трассировок.

Синтаксис​

npx playwright show-trace [options] [trace]

Примеры​

# Open trace viewer without a specific trace (can load traces via UI)
npx playwright show-trace

# View a trace file
npx playwright show-trace trace.zip

# View trace from directory
npx playwright show-trace trace/

Параметры​

Специализированные команды​

Объединение отчетов​

Читать отчеты blob и объединять их. Подробнее о merge-reports.

Синтаксис​

npx playwright merge-reports [options] <blob dir>

Примеры​

# Combine test reports
npx playwright merge-reports ./reports

Параметры​

Очистка кэша​

Очистить весь кэш Playwright.

Синтаксис​

npx playwright clear-cache