Константы и ошибки

Константы конфигурации по умолчанию

Константа	Тип	Значение	Описание
`DefaultMaxInputSize`	`int`	`52428800`	Максимальный размер ввода (50 МБ)
`DefaultMaxCacheEntries`	`int`	`2000`	Максимальное количество записей в кэше
`DefaultWorkerPoolSize`	`int`	`4`	Размер пула воркеров
`DefaultCacheTTL`	`time.Duration`	`1ч`	Время жизни записей в кэше
`DefaultCacheCleanup`	`time.Duration`	`5м`	Интервал очистки кэша
`DefaultMaxDepth`	`int`	`500`	Максимальная глубина DOM
`DefaultProcessingTimeout`	`time.Duration`	`30с`	Тайм-аут обработки

Константы аудита

Типы событий аудита

Константа	Значение	Описание
`AuditEventBlockedTag`	`"blocked_tag"`	Заблокированный тег
`AuditEventBlockedAttr`	`"blocked_attr"`	Заблокированный атрибут
`AuditEventBlockedURL`	`"blocked_url"`	Заблокированный URL
`AuditEventInputViolation`	`"input_violation"`	Нарушение ввода
`AuditEventDepthViolation`	`"depth_violation"`	Нарушение глубины
`AuditEventTimeout`	`"timeout"`	Тайм-аут обработки
`AuditEventEncodingIssue`	`"encoding_issue"`	Проблема кодировки
`AuditEventPathTraversal`	`"path_traversal"`	Попытка обхода пути

Уровни аудита

Константа	Тип	Значение	Описание
`AuditLevelInfo`	`AuditLevel`	`"info"`	Информационный уровень
`AuditLevelWarning`	`AuditLevel`	`"warning"`	Уровень предупреждения
`AuditLevelCritical`	`AuditLevel`	`"critical"`	Критический уровень

INFO

Подробное использование системы аудита и типы Sink описаны в Система аудита.

Сигнатурные ошибки

Ошибка	Сообщение	Описание
`ErrInputTooLarge`	`html: input size exceeds maximum`	Ввод превышает лимит размера
`ErrInvalidHTML`	`html: invalid HTML`	Некорректное содержимое HTML
`ErrProcessorClosed`	`html: processor closed`	Процессор закрыт
`ErrMaxDepthExceeded`	`html: max depth exceeded`	Превышена максимальная глубина
`ErrInvalidConfig`	`html: invalid config`	Некорректная конфигурация
`ErrProcessingTimeout`	`html: processing timeout exceeded`	Тайм-аут обработки
`ErrFileNotFound`	`html: file not found`	Файл не найден
`ErrInvalidFilePath`	`html: invalid file path`	Некорректный путь к файлу
`ErrInternalPanic`	`html: internal panic recovered`	Внутренняя паника восстановлена
`ErrMultipleConfigs`	`html: at most one Config may be provided`	Максимум один Config

Типы ошибок

InputError

Ошибка, связанная с вводом, содержащая информацию о размере.

type InputError struct {
    Op       string // Имя операции
    Size     int    // Фактический размер
    MaxSize  int    // Максимальный лимит
    InputErr error  // Исходная ошибка
}

func (e *InputError) Error() string
func (e *InputError) Unwrap() error // → InputErr (если не nil) или ErrInputTooLarge

ConfigError

Ошибка валидации конфигурации, содержащая информацию о поле.

type ConfigError struct {
    Field   string // Имя поля
    Value   any    // Некорректное значение
    Message string // Описание ошибки
}

func (e *ConfigError) Error() string
func (e *ConfigError) Unwrap() error // → ErrInvalidConfig

FileError

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

type FileError struct {
    Op      string // Имя операции
    Path    string // Путь к файлу
    FileErr error  // Исходная ошибка
}

func (e *FileError) Error() string        // Безопасный вывод (усечённый путь)
func (e *FileError) SafePath() string     // Возвращает только имя файла
func (e *FileError) Unwrap() error        // → ErrFileNotFound | исходная ошибка | ErrInvalidFilePath
func (e *FileError) MarshalJSON() ([]byte, error) // также усекает путь при JSON-сериализации (предотвращает утечку в ответах API)

Безопасный путь

FileError.Error() и SafePath() возвращают усечённый безопасный путь (только имя файла), предотвращая утечку пути. Для получения полного пути при внутренней отладке можно напрямую обратиться к полю Path.

Шаблон обработки ошибок

result, err := html.Extract(data)
if err != nil {
    var inputErr *html.InputError
    var configErr *html.ConfigError
    var fileErr *html.FileError

    switch {
    case errors.Is(err, html.ErrInputTooLarge):
        // Ввод слишком большой
    case errors.Is(err, html.ErrInvalidHTML):
        // Некорректный HTML
    case errors.Is(err, html.ErrFileNotFound):
        // Файл не существует
    case errors.As(err, &inputErr):
        fmt.Printf("Размер %d превышает лимит %d\n", inputErr.Size, inputErr.MaxSize)
    case errors.As(err, &configErr):
        fmt.Printf("Поле конфигурации %s некорректно: %s\n", configErr.Field, configErr.Message)
    case errors.As(err, &fileErr):
        fmt.Printf("Файл: %s\n", fileErr.SafePath())
    }
}

Константы и ошибки ​

Константы конфигурации по умолчанию ​

Константы аудита ​

Типы событий аудита ​

Уровни аудита ​

Сигнатурные ошибки ​

Типы ошибок ​

InputError ​

ConfigError ​

FileError ​

Шаблон обработки ошибок ​