Permissions.revoke()
非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。
Permissions.revoke()
は Permissions
インターフェイスのメソッドで、現在設定されている権限を既定の状態(通常は prompt
)に戻します。
このメソッドは、グローバルな Permissions
オブジェクトである navigator.permissions
に対して呼び出します。
構文
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 の権限を取り消すように要求できます。
function revokePermission() {
navigator.permissions.revoke({ name: "geolocation" }).then((result) => {
report(result.state);
});
}
ブラウザーの互換性
BCD tables only load in the browser