ФабрикаОшибок.md

ФабрикаОшибок

Публичный модуль создания структурированных ошибок. Функции возвращают стандартную ИнформацияОбОшибке, совместимую с ВызватьИсключение, но не выбрасывают создаваемую предметную ошибку. При нарушении контракта собственных аргументов функция может выбросить структурированное исключение.

Универсальные функции

Создать

ФабрикаОшибок.Создать(
    <КодОшибки>, <Сообщение>, <Данные> = Неопределено
)

Создаёт классифицированную ошибку без причины.

Параметры:

Имя	Тип и значение по умолчанию	Описание
КодОшибки	Строка	Стабильный машинный код ошибки.
Сообщение	Строка	Человекочитаемое описание ошибки.
Данные	Произвольный = Неопределено	Связанные с ошибкой данные.

Возвращаемое значение:

ИнформацияОбОшибке - новый кадр ошибки.

ОбернутьКонтекстом

ФабрикаОшибок.ОбернутьКонтекстом(
    <Причина>, <Сообщение>, <Данные> = Неопределено
)

Добавляет контекст, не изменяя машинную классификацию причины.

Параметры:

Имя	Тип и значение по умолчанию	Описание
Причина	ИнформацияОбОшибке	Непосредственная причина нового кадра.
Сообщение	Строка	Описание выполнявшейся операции.
Данные	Произвольный = Неопределено	Связанные с контекстом данные.

Возвращаемое значение:

ИнформацияОбОшибке - новый кадр контекста.

Обернуть

ФабрикаОшибок.Обернуть(
    <Причина>, <КодОшибки>, <Сообщение>, <Данные> = Неопределено
)

Оборачивает причину новой машинной классификацией.

Параметры:

Имя	Тип и значение по умолчанию	Описание
Причина	ИнформацияОбОшибке	Непосредственная причина нового кадра.
КодОшибки	Строка	Новый стабильный машинный код ошибки.
Сообщение	Строка	Человекочитаемое описание ошибки.
Данные	Произвольный = Неопределено	Связанные с ошибкой данные.

Возвращаемое значение:

ИнформацияОбОшибке - новый классифицированный кадр.