CLI
Обзор
HTML Reporter имеет следующие команды:
- gui — чтобы запускать Testplane в GUI-режиме;
- merge-reports — чтобы объединять несколько отчетов в один.
- remove-unused-screens — чтобы удалять неиспользуемые в тестах эталонные скриншоты;
При использовании HTML Reporter с Testplane, вы также можете использовать команды через Testplane, например: npx testplane gui.
При использовании с другими инструментами, необ ходимо указывать название инструмента в аргументе tool, например: npx html-reporter gui --tool playwright.
gui
Команда доступна только при использовании HTML Reporter с Testplane и Playwright.
Используйте команду gui, чтобы запустить Testplane в GUI-режиме.
GUI-режим позволяет:
- интерактивно запускать тесты;
- переключать режимы работы с дампами прямо из отчета без перезапуска testplane;
- обновлять скриншоты — визуально отсматривая их и принимая только нужные диффы;
- переиспользовать отчеты из CI;
- фильтровать результаты прогона по ошибкам, ключам из меты, и пр.
Использование
npx html-reporter gui
merge-reports
Команда доступна только при использовании HTML Reporter с Testplane и Playwright.
Используйте команду merge-reports, чтобы объединить несколько отчетов в один.
Команда принимает пути к директориям с отчетами, файлам баз данных или к файлам databaseUrls.json.
Она создает новый html-отчет в папке назначения с данными из всех переданных отчетов.
- При объединении локальных отчетов — все данные, включая SQLite базы данных и скриншоты, копируются в директорию назначения.
- При объединении отчетов по ссылке (например, если на вход переданы файлы
databaseUrls.jsonсо ссылками на отчеты в S3) — в директории назначения будет создан отчет со ссылками на исходные отчеты вdatabaseUrls.json, без скачивания и к опирования всех вложенных ресурсов. При работе с отчетом это никак не будет заметно, но нужно учитывать, что исходные отчеты должны оставаться доступными, так как объединенный отчет получает данные из них.
Использование
Команда merge-reports поддерживает следующую обязательную опцию:
| Опция | Описание |
| -d, --destination <folder> | Путь к папке, в которую нужно сохранить итоговый отчет. |
| -h, --header <header> | HTTP-заголовок для файлов databaseUrls.json из исходных путей. |
Пример использования:
npx html-reporter merge-reports report-dir/ path-to-database.db path-to-databaseUrls.json -d dest-report -h foo=bar
HTTP-заголовки также можно передавать через переменную окружения — html_reporter_headers (она имеет более высокий приоритет, чем опция CLI --header). Пример:
html_reporter_headers='{"foo":"bar"}' npx hermione merge-reports path-to-database.db path-to-databaseUrls.json -d dest-report -h baz=qux
В этом вызове path-to-databaseUrls.json будет запрошен с заголовками: {foo: 'bar', baz: 'qux'}.