このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Permissions.revoke()

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

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()notificationspush の両方に対して 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);
  });
}

ブラウザーの互換性