mailru.common.users.requirePermission js api

Показывает пользователю диалог запроса привилегии.

Эта функция объявлена устаревшей. Для приложений необходимые привилегии указываются в настройках приложения. Для сайтов и standalone-приложений используйте параметр scope в OAuth-авторизации или connect.loginjs.

Вызов доступен только из JavaScript библиотеки (не доступен для вызова с сервера).

Параметры

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

Результат

Для получения результата выполнения функции подписывайтесь на события, описанные в секции «Генерируемые события».

Генерируемые события

mailru.common.events.permissionsChange

Результат показа диалога

{
  // варианты: already/success/fail/closed, already означает что 
  // при вызове диалога разрешение уже было установлено
  'status': "success", 
  'permissionType': "widget"
}

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

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

См. также

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

Функции JS API