test_read — Документация Кванты

test_read

R · чтениепо подпискене изменяет проект

Читает прогоны тестов YaxUnit, запущенные через project_action с операцией run_tests: список прогонов со статусами и полный отчёт по прогону. Пока отчёт не собран, отвечает 🔵 running — вызов можно просто повторить.

Когда использовать

Сразу после run_tests — report без параметров показывает последний прогон; при 🔵 running повторите вызов.
Нужен прошлый прогон — list, затем report с его session_id.
Только упавшие тесты — report с filter.

Соседние инструменты домена «Проекты»

project_readRбазы и конфигурации запуска, доступные для тестов project_writeWСоздаёт новый проект в рабочей области EDT — расширение конфигурации, внешнюю обработку или внешний отчёт. Один вызов — один проект; создание идёт штатными сервисами EDT, как мастером «Новый проект».project_actionAзапустить прогон тестов — операция run_tests

Операции

Операции test_read
operation	Что делает	Нужно передать
`list`	Все прогоны рабочей области: дата, идентификатор, состояние — ожидание, успешно, с ошибками.	ничего
`report`	Полный отчёт прогона. Без `session_id` — последний прогон. Пока отчёт не готов — `🔵 running`; когда готов — или по результату тестов.	по желанию `session_id`

Параметры

Параметры test_read
Параметр и тип	Обязательный	Описание	По умолчанию
`operation`строка	нет	Операция инструмента — значения и их смысл в таблице «Операции».значения: list · report	—
`session_id`строка	нет	Идентификатор прогона для `report`, из ответа `run_tests` или `test_read list`. По умолчанию — последний прогон.	—
`limit`целое	нет	Окно чтения: сколько строк готового ответа вернуть. По умолчанию 200, максимум 1000.	`200`
`offset`целое	нет	Окно чтения: номер строки ответа, с которой начать (0 — первая страница). Значение для следующей страницы подсказывает строка `lines: …` в конце ответа.	`0`
`filter`строка	нет	Регулярное выражение без учёта регистра. Сужает вывод: оставляет строки ответа, в которых есть совпадение (заголовки секций с совпадениями сохраняются). Применяется до окна чтения.	—

Таблица собрана из схемы инструмента, которую получает агент при подключении.

Адреса

Адрес fqn не используется: прогон задаётся идентификатором session_id.

Пример вызова и ответа

аргументы test_read

{ "operation": "report", "session_id": "<идентификатор прогона>", "filter": "failed|error" }

Пример ответа в подготовке Устройство ответа — на странице Формат ответов.

Отказы и ошибки

failed · прогон не найден

Идентификатор не совпадает ни с одним прогоном: ответ Прогон не найден: <id> с подсказкой вызвать list и ближайшими идентификаторами в Did you mean.

прогонов не было

report без идентификатора, а прогонов ещё нет — ответ предлагает запустить project_action с операцией run_tests.

failed · прогон завершился без отчёта

Клиент 1С отработал, но не записал отчёт. Проверьте, что расширение YaxUnit установлено в базу и отбор нашёл тесты; путь к журналу запуска — в подсказке ответа.

failed · Unknown operation

Неизвестное значение operation. В ответе — fix_hint: supported: … со списком допустимых операций и секция Did you mean. Допустимо: list, report.

failed · лицензия

Без действующего ключа инструмент отвечает карточкой failed с сообщением лицензия: … и подсказкой, где ввести ключ; в секции Context — список инструментов, доступных без ключа. Подробнее — Лицензия и бесплатный доступ.

Ограничения

Живые данные: ответы не кэшируются, каждый вызов перечитывает состояние прогона.
Прогоны хранятся в памяти плагина: после перезапуска EDT список начинается заново.