data - объект с данными, описывающие добавляемое сообщение.
Данная функция позволяет добавить в системный журнал кастомное сообщение на более низком уровне, чем это делает функция log.
Объект data содержит поля:
- stamp - метка времени в миллисекундах (из нее формируется первая колонка журнала);
- mark - двухбуквенная метка приложения, выдающая сообщение (вторая колонка);
- type - тип сообщения, может принимать значения 'e' - ошибка (выводится красным цветом), 'i' - информация (зеленым цветом), 'd' - отладочные сообщения (белым цветом);
- val - текст сообщения.
Приммер:
let logData = { stamp: Date.now(), mark: 'ZZ', type: 'e', val: 'my message' } await ds.rpcCall('pm.addLog', [ logData ]);
Данный код добавит в системный журнал, в обход стандартной функции, сообщение my message с меткой ZZ и типом сообщения - ошибка.