Отключение хуков

Система хуков Dexie.js построена вокруг механизма перехвата операций над таблицами базы данных и позволяет внедрять дополнительную логику в моменты создания, обновления, удаления и чтения записей. В ряде архитектурных сценариев возникает необходимость отключения таких хуков полностью или временно, чтобы исключить побочные эффекты, рекурсию или избыточные вычисления.

Хуки в Dexie.js привязываются к конкретным операциям таблицы: creating, reading, updating, deleting. Каждый хук регистрируется на уровне таблицы и получает управление в момент соответствующего события.

db.users.hook('creating', (primKey, obj, transaction) => {
    obj.createdAt = Date.now();
});

Регистрация хука формирует подписку, которая возвращает управляющий объект. Этот объект становится ключевой точкой управления жизненным циклом хука, включая возможность его отключения.

Отключение хуков через unsubscribe

Каждый зарегистрированный хук возвращает объект подписки, содержащий метод unsubscribe. Это основной и наиболее прямой способ отключения логики.

const hook = db.users.hook('creating', (primKey, obj, transaction) => {
    obj.createdAt = Date.now();
});

// отключение хука
hook.unsubscribe();

После вызова unsubscribe обработчик полностью удаляется из цепочки выполнения и больше не участвует в обработке операций таблицы. Повторное выполнение операций над таблицей не вызывает данный хук.

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

Управление группами хуков

В архитектуре с большим количеством логики часто применяется группировка подписок через массивы или менеджеры жизненного цикла.

const hooks = [];

hooks.push(db.users.hook('creating', fn1));
hooks.push(db.users.hook('creating', fn2));
hooks.push(db.users.hook('updating', fn3));

// отключение всей группы
hooks.forEach(h => h.unsubscribe());

Такой подход обеспечивает централизованное управление отключением, особенно в динамических модулях приложения.

Условное отключение через флаги состояния

Одним из распространённых подходов является не физическое удаление хука, а введение флага, управляющего его активностью. Это позволяет сохранять регистрацию, но изменять поведение.

let hooksEnabled = true;

db.users.hook('creating', (primKey, obj, transaction) => {
    if (!hooksEnabled) return;
    obj.createdAt = Date.now();
});

В момент необходимости отключения достаточно изменить состояние:

hooksEnabled = false;

Такой подход используется для предотвращения рекурсивных вызовов при массовых операциях.

Временное отключение через Dexie.vip

Dexie.js предоставляет механизм выполнения операций в обход хуков и наблюдателей через Dexie.vip. Это специализированный режим исполнения, в котором обходятся зарегистрированные хуки.

Dexie.vip(() => {
    db.users.put({ id: 1, name: 'A' });
});

Операции внутри Dexie.vip выполняются без активации цепочки хуков, что делает этот механизм предпочтительным для служебных операций, миграций и внутренних синхронизаций.

Особенность заключается в том, что обходятся не только хуки creating и updating, но и связанные наблюдатели изменений, что обеспечивает «чистое» выполнение операции.

Отключение через пересборку подписок

В некоторых сценариях применяется стратегия замены хука на пустую реализацию. Это используется при необходимости сохранить ссылку на подписку, но временно нейтрализовать поведение.

let hookRef = db.users.hook('deleting', handler);

// временное отключение
hookRef.unsubscribe();

// восстановление
hookRef = db.users.hook('deleting', handler);

Данный подход применяется при динамической смене режимов работы приложения.

Изоляция хуков через транзакции

Хуки в Dexie.js привязаны к транзакционному контексту. Использование транзакций позволяет ограничивать область действия логики.

db.transaction('rw', db.users, async () => {
    db.users.hook('creating', (primKey, obj) => {
        obj.sessionScoped = true;
    });

    await db.users.add({ name: 'X' });
});

После завершения транзакции поведение становится изолированным, а зарегистрированные внутри контекста хуки не влияют на глобальное состояние.

Проблема рекурсивных вызовов

Отключение хуков часто связано с предотвращением рекурсии. При изменении данных внутри хука возможно повторное срабатывание той же цепочки.

db.users.hook('updating', (mods, primKey, obj) => {
    obj.updatedAt = Date.now();
    // потенциальная рекурсия при неправильной архитектуре
});

Для предотвращения используются комбинации Dexie.vip и флагов состояния, обеспечивающие выход из цепочки обработки.

Приоритеты и порядок выполнения

Dexie.js выполняет хуки в порядке их регистрации. Это влияет на стратегию отключения: удаление одного хука может изменить поведение всей цепочки.

const h1 = db.users.hook('creating', fn1);
const h2 = db.users.hook('creating', fn2);

// порядок: fn1 → fn2
h1.unsubscribe();

После удаления первого хука цепочка пересобирается, и выполнение становится одностадийным.

Отключение хуков на уровне базы и таблиц

Хуки могут быть привязаны как к отдельной таблице, так и к более глобальным контекстам через расширения Dexie. В зависимости от уровня регистрации применяется разная стратегия отключения.

  • Табличные хуки управляются через table.hook
  • Глобальные сценарии требуют контроля на уровне инициализации базы
  • Внешние плагины могут добавлять собственные цепочки, требующие координированного отключения

Паттерны безопасного отключения

В системах с высокой нагрузкой и сложной бизнес-логикой применяется несколько устойчивых паттернов отключения:

Контекстный флаг исполнения

const context = { internal: false };

db.users.hook('creating', (primKey, obj) => {
    if (context.internal) return;
});

Использование служебных транзакций

await db.transaction('rw', db.users, async () => {
    await Dexie.vip(() => db.users.put({ id: 1 }));
});

Динамическая регистрация

let hook;

function enable() {
    hook = db.users.hook('updating', handler);
}

function disable() {
    hook?.unsubscribe();
}

Побочные эффекты отключения

Отключение хуков влияет на согласованность данных, поскольку часть логики может перестать выполняться:

  • пропуск автоматических вычислений полей
  • отсутствие аудита изменений
  • нарушение цепочек синхронизации
  • изменение поведения транзакций

Поэтому отключение обычно ограничивается узкими участками кода и сопровождается контролем контекста исполнения.

Комбинированные стратегии

В сложных приложениях используется сочетание подходов: временное отключение через Dexie.vip, точечный unsubscribe и контекстные флаги. Это позволяет строить управляемую систему, где поведение хуков зависит от режима работы системы, а не от их статической регистрации.

Оглавление