Разрешения: метод revoke()

Метод revoke() интерфейса Permissions отменяет текущее разрешение, возвращая его к исходному состоянию, которое обычно prompt. Этот метод вызывается на глобальном объекте Permissions объекта navigator.permissions.

Этот метод удален из основного спецификации API разрешений, поскольку его целевое применение не ясно. Разрешения управляются браузером, и текущая модель разрешений не позволяет разработчику сайта императивно запрашивать или отменять разрешения. Браузеры добавили этот API с ограничениями, но маловероятно, что он достигнет стандарта. Для более подробной информации см. исходную дискуссию об удалении permissions.revoke().

permissionDescriptor

Объект, устанавливающий параметры для операции revoke. Доступные параметры для этого дескриптора зависят от типа разрешения.

Все разрешения имеют имя:

name

Строка, содержащая имя API, разрешения которого вы хотите запросить. Возвращаемый Promise будет отклонен с TypeError, если имя разрешения не поддерживается браузером.

Для разрешений push вы также можете указать:

userVisibleOnly Необязательный

(Только для Push, не поддерживается в Firefox — см. раздел Поддержка браузеров ниже) Указывает, хотите ли вы отображать уведомление для каждого сообщения или отправлять тихие push-уведомления. По умолчанию false.

Для разрешения midi вы также можете указать:

sysex Необязательный

Указывает, нужен ли вам и/или получаете ли вы системные эксклюзивные сообщения. По умолчанию false.

A Promise, который вызывает обработчик выполнения с объектом PermissionStatus, указывающим результат запроса.

TypeError

Получение информации о PermissionDescriptor не удалось по каким-либо причинам, или разрешение не существует или в настоящее время не поддерживается (например, midi, или push с userVisibleOnly).

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

function revokePermission() {
  navigator.permissions.revoke({ name: "geolocation" }).then((result) => {
    report(result.state);
  });
}