Инструменты · Отладка
debug_write
Ставит и снимает точки останова на строках модулей — с условием и счётчиком срабатываний — и меняет значение переменной в остановленном кадре. Точки можно ставить до подключения: они видны в EDT и доставляются отладчику при подключении.
Когда использовать
- Остановить выполнение на нужной строке —
set; только при определённом условии —condition. - Убрать за собой —
clearсclear_all: true: удаляются только точки, поставленные через Кванту. - Проверить гипотезу на лету —
modify_value: поменять значение переменной и продолжить.
Соседние инструменты домена «Отладка»
Операции
| operation | Что делает | Нужно передать |
|---|---|---|
set | Точка останова на строке модуля. Пустая строка или комментарий — отказ с ближайшей исполняемой строкой. | project, module_fqn, line; по желанию condition, hit_count |
clear | Снимает точку по модулю и строке или все точки Кванты (clear_all); точки человека остаются и пересчитываются в ответе. | module_fqn и line или clear_all: true |
modify_value | Меняет значение переменной остановленного кадра; ответ показывает «было → стало». | path, value; по желанию target, frame |
Параметры
| Параметр и тип | Обязательный | Описание | По умолчанию |
|---|---|---|---|
operationстрока | да | Операция инструмента — значения и их смысл в таблице «Операции».значения: set · clear · modify_value | — |
projectстрока | нет | Проект EDT модуля; у расширения — свой проект. | — |
module_fqnстрока | нет | Адрес модуля: ОбщийМодуль.X, Справочник.X.МодульОбъекта, Документ.X.Форма.Y. | — |
lineцелое | нет | Номер строки модуля с единицы. | — |
conditionстрока | нет | Условие точки — выражение встроенного языка. | — |
hit_countцелое | нет | Счётчик срабатываний точки. | — |
clear_allбулево | нет | Для clear: снять все точки, поставленные через Кванту; точки человека остаются. | — |
pathстрока | нет | Для modify_value: путь переменной остановленного кадра, например Отказ или ТаблицаТоваров[0].Количество. | — |
valueстрока | нет | Для modify_value: литерал встроенного языка — Истина, 10, "текст", '20260609'. | — |
targetстрока | нет | Для modify_value: метка предмета отладки; по умолчанию — единственный остановленный. | — |
frameцелое | нет | Для modify_value: номер кадра стека, 0 — верхний. | — |
titleстрока | нет | Необязательная подпись вызова до 40 символов: клиент показывает её в шапке карточки вызова. На результат не влияет. | — |
Таблица собрана из схемы инструмента, которую получает агент при подключении.
Адреса
Модуль задаётся параметром module_fqn, строка — line.
Пример вызова и ответа
Точек, поставленных через Кванту, нет — ответ ⚪ noop, ничего не удалено.
{ "operation": "clear", "clear_all": true }### ⚪ clear — breakpoints
- **status:** ⚪ noop — Quanta-точек нет
- **cleared:** 0Отказы и ошибки
Неисполняемая строка
На пустой строке или комментарии точка не ставится — ответ 🔴 с ближайшей исполняемой строкой.
failed · Unknown operation
Неизвестное значение operation. В ответе — fix_hint: supported: … со списком допустимых операций и секция Did you mean. Допустимо: set, clear, modify_value.
failed · лицензия
Без действующего ключа инструмент отвечает карточкой failed с сообщением лицензия: … и подсказкой, где ввести ключ; в секции Context — список инструментов, доступных без ключа. Подробнее — Лицензия и бесплатный доступ.
Ограничения
- Точки, поставленные через Кванту, помечены отдельно:
clear_allне трогает точки человека. - Изменённые значения живут только в текущем выполнении и в конфигурацию не попадают.