#Події

Сервер NocoBase генерує відповідні події протягом життєвого циклу застосунку, життєвого циклу плагінів та під час операцій з базою даних. Розробники плагінів можуть прослуховувати ці події для реалізації розширеної логіки, автоматизованих операцій або власної поведінки.

Система подій NocoBase поділяється на два основні рівні:

• app.on() - Події рівня застосунку: Прослуховують події життєвого циклу застосунку, такі як запуск, встановлення, увімкнення плагінів тощо.
• db.on() - Події рівня бази даних: Прослуховують події операцій на рівні моделі даних, такі як створення, оновлення, видалення записів тощо.

Обидва успадковують функціонал від EventEmitter Node.js, підтримуючи стандартні інтерфейси .on(), .off() та .emit(). NocoBase також розширює підтримку emitAsync, що використовується для асинхронного запуску подій та очікування завершення виконання всіх слухачів.

#Місце реєстрації слухачів подій

Слухачі подій зазвичай слід реєструвати у методі beforeLoad() плагіна. Це гарантує, що події будуть готові вже на етапі завантаження плагіна, і подальша логіка зможе коректно на них реагувати.

import { Plugin } from '@nocobase/server';

export default class PluginHelloServer extends Plugin {
  async beforeLoad() {

    // Прослуховування подій застосунку
    this.app.on('afterStart', () => {
      app.logger.info('NocoBase запущено');
    });

    // Прослуховування подій бази даних
    this.db.on('afterCreate', (model) => {
      if (model.collectionName === 'posts') {
        app.logger.info(`Новий допис: ${model.get('title')}`);
      }
    });
  }
}

#Прослуховування подій застосунку app.on()

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

#Поширені типи подій

Приклад: Прослуховування події запуску застосунку

app.on('afterStart', async () => {
  app.logger.info('🚀 Сервіс NocoBase запущено!');
});

Приклад: Прослуховування події завантаження плагіна

app.on('afterLoadPlugin', ({ plugin }) => {
  app.logger.info(`Плагін ${plugin.name} завантажено`);
});

#Прослуховування подій бази даних db.on()

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

#Поширені типи подій

Приклад: Прослуховування події після створення даних

db.on('afterCreate', async (model, options) => {
  db.logger.info('Дані створено!');
});

Приклад: Прослуховування події перед оновленням даних

db.on('beforeUpdate', async (model, options) => {
  db.logger.info('Дані будуть оновлені!');
});