Sidminik: Sidminik переименовал страницу Модуль логгирования в Модуль логирования

2026-02-05T09:40:25Z

Sidminik переименовал страницу Модуль логгирования в Модуль логирования

← Предыдущая версия	Версия от 09:40, 5 февраля 2026
(нет различий)

Sidminik: Новая страница: «Для журналирования необходимо использовать модуль `@chemsoft/logger`. Стандартный лог располагается в директории `log/lis_node.log`. Модуль логгирования полностью переписан (ранее был основан на логгере `winston`). const { createConsoleAndFileLogger...»

2026-01-13T06:56:07Z

Новая страница: «Для журналирования необходимо использовать модуль <code>@chemsoft/logger</code>. Стандартный лог располагается в директории <code>log/lis_node.log</code>. Модуль логгирования полностью переписан (ранее был основан на логгере <code>winston</code>). <syntaxhighlight lang="javascript"> const { createConsoleAndFileLogger...»

Новая страница

Для журналирования необходимо использовать модуль <code>@chemsoft/logger</code>. Стандартный лог располагается в директории <code>log/lis_node.log</code>. Модуль логгирования полностью переписан (ранее был основан на логгере <code>winston</code>).

<syntaxhighlight lang="javascript">
const { createConsoleAndFileLogger } = require("@chemsoft/logger");
</syntaxhighlight>

===Экспортируемые сущности===
Для импорта сущности из пакета используется деструктуризация объекта:

<syntaxhighlight lang="javascript">
const {
createEmptyLogger,
createConsoleAndFileLogger,
ConsolePrinter,
FilePrinter,
} = require("@chemsoft/logger");
</syntaxhighlight>

===Интерфейс <code>IPrinter</code>===
Интерфейс описывает сущность стандартного принтера (в данный момент реализованы в консоль и в файл)

<syntaxhighlight lang="javascript">
declare interface IPrinter {
debug(...msg: any[]): void;
info(...msg: any[]): void;
warning(...msg: any[]): void;
error(...msg: any[]): void;
}
</syntaxhighlight>

===Интерфейс <code>ILogger</code>===
Интерфейс описывает сущность логгера. Реализованы паттерны мост и прокси-команда. Через паттерн мост добавляются новые принтеры, через прокси-команду делегируется выполнение методов с сохранением исходного API IPrinter. Также содержит уровни логгирования.

<syntaxhighlight lang="javascript">
declare interface ILogger extends IPrinter {
registerPrinter(printer: IPrinter): void;
level: LogLevel;
}
</syntaxhighlight>

===Фабрика <code>createEmptyLogger()</code>===
Создает пустой логгер. Т.к. логгер не содержит в себе реализации, то ему обязательно нужно будет передать принтер.

<code>return: ILogger</code> возвращает пустой логгер (описание в интерфейсе <code>ILogger</code>)

<syntaxhighlight lang="javascript">
function createEmptyLogger(): ILogger
</syntaxhighlight>

===Фабрика <code>createConsoleAndFileLogger()</code>===
Создает логгер, в котором уже зарегистрированы принтеры и для консоли, и для файла. Конечно, при желании можно будет зарегистрировать еще принтеры, и писать таким образов в два файла сразу, например.

<code>filepath: string</code> путь для файлового принтера

<code>return: ILogger</code> возвращает пустой логгер (описание в интерфейсе <code>ILogger</code>)

<syntaxhighlight lang="javascript">
function createConsoleAndFileLogger(filepath): ILogger
</syntaxhighlight>

===Класс <code>ConsolePrinter</code>===
Создает принтер для консоли. В целом самостоятелен, но полный функционал логгера (уровни логгирования) раскрываются именно в связке с логгером.

<code>return: IPrinter</code> возвращает файловый принтер (описание в интерфейсе <code>IPrinter</code>)

<syntaxhighlight lang="javascript">
ConsolePrinter.constructor(): IPrinter
</syntaxhighlight>

===Класс <code>FilePrinter</code>===
Создает принтер для файлов. В целом самостоятелен, но полный функционал логгера (уровни логгирования) раскрываются именно в связке с логгером.

<code>filepath: string</code> путь для файлового принтера

<code>return: IPrinter</code> возвращает файловый принтер (описание в интерфейсе <code>IPrinter</code>)

<syntaxhighlight lang="javascript">
FilePrinter.constructor(filepath): IPrinter
</syntaxhighlight>

Модуль логирования - История изменений

Sidminik: Sidminik переименовал страницу Модуль логгирования в Модуль логирования