From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/permissions/revoke/index.html | 90 ++++++++++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 files/ja/web/api/permissions/revoke/index.html (limited to 'files/ja/web/api/permissions/revoke/index.html') diff --git a/files/ja/web/api/permissions/revoke/index.html b/files/ja/web/api/permissions/revoke/index.html new file mode 100644 index 0000000000..2ffebf2cb5 --- /dev/null +++ b/files/ja/web/api/permissions/revoke/index.html @@ -0,0 +1,90 @@ +--- +title: Permissions.revoke() +slug: Web/API/Permissions/revoke +tags: + - API + - Experimental + - Method + - Permissions + - Permissions API + - Reference + - revoke +translation_of: Web/API/Permissions/revoke +--- +

{{APIRef("Permissions API")}}{{SeeCompatTable}}

+ +

{{domxref("Permissions")}} インターフェイスの Permissions.revoke() メソッドは、現在設定されているパーミッションをデフォルト状態（通常は prompt）に戻します。

+ +

構文

+ +

このメソッドは、グローバルな {{domxref("Permissions")}} オブジェクトである {{domxref("navigator.permissions")}} に対して呼び出します。

+ +
var revokePromise = navigator.permissions.revoke(descriptor);
+
+ +

パラメーター

+ +
+
descriptor
+
名前と値のペアのコンマ区切りリストで構成される、操作のオプションを設定する PermissionDescriptor ディクショナリに基づくオブジェクト。 利用可能なオプションは次のとおりです。 +
    +
  • name: パーミッションを照会したい API の名前。 有効な値は、'geolocation'、'midi'、'notifications'、'push' です。
    • +
  • userVisibleOnly: Push のみ。 Firefox はサポートしていません。 下記の{{anch("Browser compatibility","ブラウザーの互換性")}}のセクションを参照してください）すべてのメッセージについて通知を表示するか、サイレントプッシュ通知を送信できるかを示します。 デフォルトは false です。
    • +
  • sysex: （MIDI のみ）システムエクスクルーシブメッセージが必要か受信するかどうかを示します。 デフォルトは false です。
    • +
+
+
+ +
+

注: Firefox 44 以降、Notifications と Push のパーミッションは統合されました。 （例えば、ユーザーによって、関連するパーミッションのダイアログにより）パーミッションが与えられた場合、navigator.permissions.query() は notifications と push の両方に対して true を返します。

+
+ +
+

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

+
+ +

戻り値

+ +

要求の結果を示す {{domxref("PermissionStatus")}} オブジェクトと共に成功ハンドラを呼び出す {{jsxref("Promise")}}。

+ +

例外

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

例

+ +

この関数をアプリで使用して、それが有する Geolocation API のパーミッションを取り消すように要求できます。

+ +
function revokePermission() {
+  navigator.permissions.revoke({name:'geolocation'}).then(function(result) {
+    report(result.state);
+  });
+}
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Permissions API','#dom-permissions-revoke','revoke()')}}{{Spec2('Permissions API')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.Permissions.revoke")}}

+
-- cgit v1.2.3-54-g00ecf