mirror of
https://github.com/salexdv/bsl_console.git
synced 2024-11-24 08:33:29 +02:00
3.4 KiB
3.4 KiB
Функция setMarkers
Назначение функции
Функция позволяет задать маркеры (выделения) для определенных позиций в текущем текста редактора
Параметры функции
- markersJSON - строка, маркеры в виде массива JSON-объектов, содержащих следующие поля:
- [lineNumber] - число, номер строки, для которой необходимо задать маркер
- [message] - строка, текст сообщения, который появляется при наведении на маркер
- [severity] - строка, тип маркера. Значне по умолчанию: Error. Необязательный параметр. Может принимать одно из следующих значений:
- Error - ошибка
- Hint - подсказка
- Info - информация
- Warning - предупреждение
- [startColumn] - число, начальный номер колонки для выделения маркером. Необязательный параметр
- [endColumn] - число, конечный номер колонки для выделения маркером. Необязательный параметр
- [code] - строка, код, выделяемый в сообщении. Необязательный параметр
- [source] - строка, источник, выделяемый в сообщении. Необязательный параметр
Возвращаемое значение
В случае успешного выполнения возвращается true
. Если в процессе выполнения возникает какая-либо ошибка, то функция возвращает объект, содержащий поле errorDescription
.
Особенности
Функция обновляет все маркеры, а не добавляет их. Для сброса всех маркеров, в качестве параметра необходимо передать пустой массив.
Пример вызова
setMarkers(`[
{
"lineNumber": 1,
"severity": "Error",
"message": "Не рекомендуется использовать функцию НайтиПоНаименованию",
"code": "Рога и копыта",
"source": "НайтиПоНаименованию"
},
{
"lineNumber": 23,
"severity": "Hint",
"message": "Функция устарела, следует использовать СообщениеПользователю",
"code": "Контрагент не найден",
"source": "Сообщить"
},
{
"lineNumber": 45,
"severity": "Info",
"message": "Длина строки 137 превышает максимально допустимую 120",
"code": "LineLength",
"source": "bsl-language-server"
},
{
"lineNumber": 71,
"severity": "Warning",
"message": "Превышен допустимый уровень вложенности управляющих конструкций",
"code": "ПроверкаВложенности",
"source": "ПроверкаКода"
}
]`);