mailru.events.listen js api

Добавляет функцию-обработчик для события.

Некоторые действия пользователь может сделать самостоятельно с помощью кнопок на канве вашего приложения, а так же с помощью диалогов, которые ваше приложение может поднимать. Для таких случаев предусмотрен механизм событий. Когда пользователь производит действие, например, дает вашему приложению привилегию на установку виджета, не важно из диалога, поднятого вами с помощью Javascript библиотеки, или из интерфейса Моего Мира, вызывается ваша функция-обработчик, которая реагирует на это событие как вам нужно.

Параметры

Имя Тип Описание
eventobjectсобытие, на которое надо подписаться; обязательный параметр
callbackfunctionфункция, которую надо вызвать при возникновении события; обязательный параметр

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

Результат

Функция возвращает id обработчика, который может использоваться при обращении к функции events.removejs.

Пример вызова

mailru.events.listen(mailru.common.events.permissionsChange, function(event) {
  // эта функция будет вызываться при изменении привилегий приложения
});

См. также

Использование JS API

Функции JS API