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

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

После connect — какие предметы отладки есть и их метки t1, t2.
Человек выполняет сценарий — wait в цикле, пока выполнение не остановится на точке.
Остановились — stack, затем variables по пути значения, evaluate для выражения.

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

debug_writeWпоставить или снять точку останова, изменить значение переменной debug_actionAподключиться, шагать, продолжить, отключиться

Операции

Операции debug_read
operation	Что делает	Нужно передать
`breakpoints`	Все точки останова рабочей области — поставленные через Кванту и человеком; работает без сессии отладки.	по желанию `project`
`targets`	Предметы отладки с метками `t1`, `t2`: выполняется, остановлен (с местом), завершён.	ничего
`wait`	Ждёт остановки: сначала проверяет уже остановленные предметы, затем опрашивает до срабатывания точки или `timeout_ms`. Повторять в цикле дёшево.	по желанию `target`, `timeout_ms`
`stack`	Кадры стека остановленного предмета; `args` управляет показом параметров со значениями.	по желанию `target`, `args`
`variables`	Переменные кадра: значение по пути раскрывается на один уровень, глубже — маркер `▸`. У таблицы значений — сводка, `.Элементы` — страница строк таблицей.	по желанию `frame`, `path`, `rows`
`evaluate`	Вычисляет выражение встроенного языка в контексте кадра с той же адресацией и страницами. Может иметь побочные эффекты, если выражение вызывает методы, меняющие данные.	`expression`; по желанию `frame`, `rows`

Параметры

Параметры debug_read
Параметр и тип	Обязательный	Описание	По умолчанию
`operation`строка	да	Операция инструмента — значения и их смысл в таблице «Операции».значения: breakpoints · targets · wait · stack · variables · evaluate	—
`project`строка	нет	Для `breakpoints`: отбор по проекту EDT.	—
`target`строка	нет	Метка предмета отладки `t1`, `t2` из `targets`. По умолчанию: у `wait` — все, у остальных — единственный остановленный.	—
`timeout_ms`целое	нет	Для `wait`: сколько ждать, мс. По умолчанию 15000, максимум 60000; клиентский таймаут обычно меньше — лучше 15–25 секунд и повтор.	—
`args`строка	нет	Для `stack`: `top` — параметры со значениями у трёх верхних кадров (по умолчанию), `all` — у всех, `none` — без параметров.	—
`frame`целое	нет	Для `variables` и `evaluate`: номер кадра стека, 0 — верхний.	—
`path`строка	нет	Для `variables`: путь значения — `Имя`, `Имя.Свойство`, `Имя[0]`, `Имя.Элементы` (страница строк таблицей).	—
`expression`строка	нет	Для `evaluate`: выражение встроенного языка, например `Запрос.Выполнить().Выгрузить()`; `.Элементы` в конце — страница строк.	—
`rows`строка	нет	Для `variables` и `evaluate`: диапазон строк живой коллекции с единицы, например `21-40`; по умолчанию `1-20`, не больше 50. Каждая ячейка — отдельное вычисление в отладчике.	—
`limit`целое	нет	Окно чтения: сколько строк готового ответа вернуть. По умолчанию 200, максимум 1000.	`200`
`offset`целое	нет	Окно чтения: номер строки ответа, с которой начать (0 — первая страница). Значение для следующей страницы подсказывает строка `lines: …` в конце ответа.	`0`
`filter`строка	нет	Регулярное выражение без учёта регистра. Сужает вывод: оставляет строки ответа, в которых есть совпадение (заголовки секций с совпадениями сохраняются). Применяется до окна чтения.	—

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

Адреса

Адрес fqn не используется: предмет отладки задаётся меткой target, значение — путём path или выражением expression.

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

аргументы debug_read

{ "operation": "variables", "path": "Объект.Товары.Элементы", "rows": "21-40" }

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

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

Нет сессии отладки

wait, stack, variables, evaluate требуют подключения — debug_action с операцией connect. Точки останова читаются и без него.

Ошибка в выражении

Разборщик выражений отладчика беднее полного встроенного языка: длинные цепочки от Новый разбейте на шаги — сначала переменная, затем её свойства через path.

failed · Unknown operation

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

failed · лицензия

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

Ограничения

Ответы не кэшируются: каждый вызов читает живой процесс.
Окно limit/offset работает поверх полученного ответа; строки таблиц листайте параметром rows.