Перейти к основному содержимому

FormErrorHandler

Defined in: core/utils/error-handler.ts:78

Централизованный обработчик ошибок для форм

Обеспечивает:

  • Единообразное логирование ошибок в DEV режиме
  • Гибкие стратегии обработки (throw/log/convert)
  • Типобезопасное извлечение сообщений из Error/string/unknown

Example​

// В async validator (конвертировать в ValidationError)
try {
  await validateEmail(value);
} catch (error) {
  return FormErrorHandler.handle(error, 'EmailValidator', ErrorStrategy.CONVERT);
}

// В behavior applicator (пробросить критичную ошибку)
try {
  applyBehavior(schema);
} catch (error) {
  FormErrorHandler.handle(error, 'BehaviorApplicator', ErrorStrategy.THROW);
}

// В validator (залогировать и продолжить)
try {
  validator(value);
} catch (error) {
  FormErrorHandler.handle(error, 'Validator', ErrorStrategy.LOG);
}

Constructors​

Constructor​

new FormErrorHandler(): FormErrorHandler;

Returns​

FormErrorHandler

Methods​

createValidationError()​

static createValidationError(
   code, 
   message, 
   field?): ValidationError;

Defined in: core/utils/error-handler.ts:214

Создать ValidationError с заданными параметрами

Утилитная функция для создания ValidationError объектов

Parameters​

code​

string

Код ошибки

message​

string

Сообщение ошибки

field?​

string

Поле (опционально)

Returns​

ValidationError

ValidationError объект

Example​

const error = FormErrorHandler.createValidationError(
  'required',
  'This field is required',
  'email'
);
// { code: 'required', message: 'This field is required', field: 'email' }

handle()​

static handle(
   error, 
   context, 
   strategy): void | ValidationError;

Defined in: core/utils/error-handler.ts:118

Обработать ошибку согласно заданной стратегии

Parameters​

error​

unknown

Ошибка для обработки (Error | string | unknown)

context​

string

Контекст ошибки для логирования (например, 'AsyncValidator', 'BehaviorRegistry')

strategy​

ErrorStrategy = ErrorStrategy.THROW

Стратегия обработки (THROW | LOG | CONVERT)

Returns​

void | ValidationError

ValidationError если strategy = CONVERT, undefined если strategy = LOG, никогда не возвращается если strategy = THROW

Example​

// THROW - пробросить ошибку
try {
  riskyOperation();
} catch (error) {
  FormErrorHandler.handle(error, 'RiskyOperation', ErrorStrategy.THROW);
  // Этот код никогда не выполнится
}

// LOG - залогировать и продолжить
try {
  nonCriticalOperation();
} catch (error) {
  FormErrorHandler.handle(error, 'NonCritical', ErrorStrategy.LOG);
  // Продолжаем выполнение
}

// CONVERT - конвертировать в ValidationError
try {
  await validator(value);
} catch (error) {
  const validationError = FormErrorHandler.handle(
    error,
    'AsyncValidator',
    ErrorStrategy.CONVERT
  );
  return validationError;
}

isValidationError()​

static isValidationError(value): value is ValidationError;

Defined in: core/utils/error-handler.ts:237

Проверить, является ли объект ValidationError

Type guard для ValidationError

Parameters​

value​

unknown

Значение для проверки

Returns​

value is ValidationError

true если value является ValidationError

Example​

if (FormErrorHandler.isValidationError(result)) {
  console.log(result.code); // OK, типобезопасно
}