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/query/index.html | 96 +++++++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 files/ja/web/api/permissions/query/index.html (limited to 'files/ja/web/api/permissions/query') diff --git a/files/ja/web/api/permissions/query/index.html b/files/ja/web/api/permissions/query/index.html new file mode 100644 index 0000000000..ddef6ca033 --- /dev/null +++ b/files/ja/web/api/permissions/query/index.html @@ -0,0 +1,96 @@ +--- +title: Permissions.query() +slug: Web/API/Permissions/query +tags: + - API + - Experimental + - Method + - Permissions + - Reference +translation_of: Web/API/Permissions/query +--- +

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

+ +

{{domxref("Permissions")}} インターフェイスの Permissions.query() メソッドは、グローバルスコープに対するユーザーのパーミッションの状態を返します。

+ +

構文

+ +
navigator.permissions.query(PermissionDescriptor).then(function(permissionStatus) { ... })
+ +

パラメーター

+ +
+
PermissionDescriptor
+
名前と値のペアのカンマ区切りリストで構成される、query 操作のオプションを設定するオブジェクト。 利用可能なオプションは次のとおりです。 +
    +
  • name: パーミッションを照会したい API の名前。 有効な値は 'accelerometer'、'accessibility-events'、'ambient-light-sensor'、'background-sync'、'camera'​、'clipboard-read'、'clipboard-write'、'geolocation'、'gyroscope'、'magnetometer'、'microphone'、'midi'、'notifications'、'payment-handler'、'persistent-storage'、'push' です。
    • +
  • userVisibleOnly: （Push のみ。 Firefox はサポートしていません。 下記のブラウザーの互換性のセクションを参照してください）すべてのメッセージについて通知を表示するか、サイレントプッシュ通知を送信できるかを示します。 デフォルトは false です。
    • +
  • sysex: （Midi のみ）システムエクスクルーシブメッセージが必要か受信するかどうかを示します。 デフォルトは false です。
    • +
+
+
+ +
+

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

+
+ +
+

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

+
+ +

戻り値

+ +

{{domxref("PermissionStatus")}} オブジェクトに解決される {{jsxref("Promise")}}。

+ +

例外

+ + + + + + + + + + + + + + +
例外説明
TypeErrorPermissionDescriptor 情報の取得が何らかの理由で失敗したか、パーミッションが存在しないか現在サポートされていません（例えば、midi、または userVisibleOnly と一緒の push で）。
+ +

例

+ +
navigator.permissions.query({name:'geolocation'}).then(function(result) {
+ if (result.state == 'granted') {
+   showLocalNewsWithGeolocation();
+ } else if (result.state == 'prompt') {
+   showButtonToEnableLocalNews();
+ }
+ // パーミッションが拒否された場合は何もしないでください。
+});
+ +

仕様

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

ブラウザーの互換性

+ +
+ + +

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

+
-- cgit v1.2.3-54-g00ecf