JavaScript події

Фронтенд‑віджети та модулі інтеграції генерують низку JavaScript‑івентів, які дозволяють розробникам реагувати на дії користувачів, оновлення даних та внутрішні стани системи.
Ці події можна використовувати для аналітики, кастомної логіки або розширення поведінки інтерфейсу.

Нижче наведено список підтримуваних подій, їхній формат та приклади використання.

Івент: SpefixSearchFinished

Цей кастомний івент викликається автоматично після завершення пошукового запиту через внутрішню пошукову систему Spefix. Він дозволяє відстежувати, що саме шукав користувач та чи були знайдені результати.

Івент надсилається на об’єкт window і містить дані у полі detail. Це стандартний механізм CustomEvent у JavaScript.

---

Структура івенту

Параметр	Тип	Опис
type	string	Назва івенту: 'SpefixSearchFinished'
detail.query	string	Пошуковий запит, введений користувачем
detail.count	number	Кількість знайдених результатів (може бути 0)

Приклад об’єкта event:

{
  detail: {
    query: 'рюкзак для ноутбука',
    count: 14
  }
}

Як слухати івент (приклад використання)

JavaScript

window.addEventListener('SpefixSearchFinished', function(event) {
  console.log('Пошук:', event.detail.query);
  console.log('Результатів знайдено:', event.detail.count);

  // Інтеграція з ESPutnik (через eS)
  eS('sendEvent', 'SearchRequest', {
    "SearchRequest": {
      "search": event.detail.query,
      "isFound": event.detail.count
    }
  });
});

TypeScript

window.addEventListener('SpefixSearchFinished', ((event: CustomEvent<{ query: string; count: number }>) => {
  console.log('Пошук', event.detail.query);
  console.log('Результатів знайдено:', event.detail.count);

  // Інтеграція з ESPutnik (через eS)
  eS('sendEvent', 'SearchRequest', {
    "SearchRequest": {
      "search": event.detail.query,
      "isFound": event.detail.count
    }
  });
}) as EventListener)

Івент: SpefixSearchInit

Цей кастомний івент викликається автоматично після інтеграції пошукового віджета на ваш сайт.

Як слухати івент (приклад використання)

window.addEventListener('SpefixSearchInit', () => {
  console.log('SpefixSearchInit')
})