Permissions.revoke()

非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

Permissions.revoke() は Permissions インターフェイスのメソッドで、現在設定されている権限を既定の状態（通常は prompt）に戻します。 このメソッドは、グローバルな Permissions オブジェクトである navigator.permissions に対して呼び出します。

構文

js
revoke(descriptor)

引数

descriptor

名前と値のペアのカンマ区切りリストで構成される、操作のオプションを設定する PermissionDescriptor 辞書に基づくオブジェクト。 利用可能なオプションは次のとおりです。

name

権限を照会したい API の名前。 有効な値は、'geolocation'、'midi'、'notifications'、'push' です。

userVisibleOnly

Push のみ。 Firefox は対応していません。 下記のブラウザーの互換性の節を参照してください）すべてのメッセージについて通知を表示するか、サイレントプッシュ通知を送信できるかを示します。 既定値は false です。

sysex （MIDI のみ）

システムエクスクルーシブメッセージが必要か受信するかどうかを示します。 既定値は false です。

メモ: Firefox 44 以降、通知 とプッシュの権限は統合されました。 （例えば、ユーザーによって、関連する権限のダイアログにより）権限が与えられた場合、　navigator.permissions.query() は notifications と push の両方に対して true を返します。

メモ: persistent-storage 権限は、ストレージ API のとおりに、オリジンがそのストレージとして永続的ボックス（すなわち永続的ストレージ（persistent storage））を使用することを許可します。

返値

Promise で、要求の結果を示す PermissionStatus オブジェクトで履行ハンドラーを呼び出します。

例外

TypeError

PermissionDescriptor 情報の取得が何らかの理由で失敗したか、アクセス権が存在しないか現在サポートされていません（例えば、midi、または userVisibleOnly と一緒の push で）。

例

この関数をアプリで使用して、それが有する Geolocation API の権限を取り消すように要求できます。

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

ブラウザーの互換性

BCD tables only load in the browser