From 0be9831e1b6339b1aa6f62fe4236583b9ad7272f Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Fri, 5 Jul 2024 00:17:33 +0900 Subject: [PATCH] =?UTF-8?q?2024/05/13=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../api/bluetooth/getavailability/index.md | 28 +++++++++++-------- .../ja/web/api/bluetooth/getdevices/index.md | 16 +++++------ 2 files changed, 25 insertions(+), 19 deletions(-) diff --git a/files/ja/web/api/bluetooth/getavailability/index.md b/files/ja/web/api/bluetooth/getavailability/index.md index b8d3768065d3d8..e2771879b74881 100644 --- a/files/ja/web/api/bluetooth/getavailability/index.md +++ b/files/ja/web/api/bluetooth/getavailability/index.md @@ -1,17 +1,20 @@ --- title: "Bluetooth: getAvailability() メソッド" +short-title: getAvailability() slug: Web/API/Bluetooth/getAvailability l10n: - sourceCommit: 1f216a70d94c3901c5767e6108a29daa48edc070 + sourceCommit: 502e8c3f0be95c6f42afe6a72113b029b290b9e8 --- -{{securecontext_header}}{{SeeCompatTable}}{{APIRef("Bluetooth API")}} +{{APIRef("Bluetooth API")}}{{SeeCompatTable}}{{securecontext_header}} -{{DOMxRef("Bluetooth")}} インターフェイスの **`getAvailability()`** メソッドは、デバイスに Bluetooth アダプターがある場合は `true` を返し、そうでない場合は `false` を返します。(ユーザーがブラウザーを本当の値を公開しないよう設定した場合は除きます) +**`getAvailability()`** は {{DOMxRef("Bluetooth")}} インターフェイスのメソッドで、（端末に Bluetooth アダプターがあるために）ユーザーエージェントが Bluetooth に対応する場合は実質的に `true` を返し、そうでない場合は `false` を返します。 -> **メモ:** `getAvailability()` が `true` を返す場合でも、ユーザーが Web Bluetooth API の使用を許可しないかもしれません。 -> ({{DOMxRef("Bluetooth.requestDevice","navigator.bluetooth.requestDevice()")}} が {{DOMxRef("BluetoothDevice")}} で解決しないかもしれません) -> また、ユーザーはブラウザーを本当の値ではなく固定の値を返すよう設定する可能性があります。 +もし Web Bluetooth API を使用する権限が [`Permissions-Policy: bluetooth`](/ja/docs/Web/HTTP/Headers/Permissions-Policy/bluetooth) 権限によって許可されていない場合、このメソッドは常に `false` を返すため、「実質的に」という言葉を使用しています。 +さらに、ユーザーはブラウザーが動作可能な Bluetooth アダプターを持っている場合でも、`getAvailability()` の呼び出しで `false` を返すように構成することができます。その逆も同様です。アクセスがその権限によってブロックされている場合、この設定値は無視されます。 + +`getAvailability()` が `true` を返し、端末に実際に Bluetooth アダプターがある場合でも、{{DOMxRef("Bluetooth.requestDevice","navigator.bluetooth.requestDevice()")}} が {{DOMxRef("BluetoothDevice")}} で解決しないかもしれません。 +Bluetooth アダプタに電源が供給されていない可能性や、ユーザーがプロンプトが表示されたときに API を使用する権限を拒否する可能性があります。 ## 構文 @@ -25,20 +28,23 @@ getAvailability() ### 返値 -{{JSxRef("Boolean")}} で解決する {{JSxRef("Promise")}} を返します。 +論理値で解決する {{JSxRef("Promise")}} を返します。 + +この {{JSxRef("Promise")}} は、[`Permissions-Policy: bluetooth`](/ja/docs/Web/HTTP/Headers/Permissions-Policy/bluetooth) によってアクセスが許可されていない場合、ユーザーが常に `false` で解決するようにブラウザーが構成されている場合、または端末に Bluetooth アダプターがない場合に `false` の値を持ちます。 +そうでない場合は `true` で解決されます。 -## 例外 +### 例外 -このメソッドは例外を投げません。 +なし。 ## 例 -この断片は、Bluetooth に対応しているかを表すメッセージをコンソールに出力します。 +以下のスニペットは、Bluetooth に端末が対応しているかどうかを指定するメッセージをコンソールに出力します。 ```js navigator.bluetooth.getAvailability().then((available) => { if (available) { - console.log("このデバイスは Bluetooth に対応しています！"); + console.log("この端末は Bluetooth に対応しています！"); } else { console.log("残念！Bluetooth に対応していません"); } diff --git a/files/ja/web/api/bluetooth/getdevices/index.md b/files/ja/web/api/bluetooth/getdevices/index.md index 579449a073e491..bde20fc6cf508f 100644 --- a/files/ja/web/api/bluetooth/getdevices/index.md +++ b/files/ja/web/api/bluetooth/getdevices/index.md @@ -1,15 +1,14 @@ --- title: "Bluetooth: getDevices() メソッド" +short-title: getDevices() slug: Web/API/Bluetooth/getDevices l10n: - sourceCommit: 1f216a70d94c3901c5767e6108a29daa48edc070 + sourceCommit: 502e8c3f0be95c6f42afe6a72113b029b290b9e8 --- -{{securecontext_header}}{{SeeCompatTable}}{{APIRef("Bluetooth API")}} +{{APIRef("Bluetooth API")}}{{SeeCompatTable}}{{securecontext_header}} -[Web Bluetooth API](/ja/docs/Web/API/Web_Bluetooth_API) の {{DOMxRef("Bluetooth")}} インターフェイスの **`getDevices()`** メソッドは、オリジンがアクセスを許可されている Bluetooth デバイスを公開します。このメソッドは許可を要求するプロンプトを表示しません。 - -> **メモ:** このメソッドは、圏外だったり電源が切られていたりするものを含め、オリジンが現在アクセスを許可されている各デバイスに対応する {{DOMxRef("BluetoothDevice")}} を返します。 +**`getDevices()`** は {{DOMxRef("Bluetooth")}} インターフェイスのメソッドで、このオリジンがアクセスを許可されている Bluetooth 機器を含む配列を返します。圏外だったり電源が切られていたりするものを含みます。 ## 構文 @@ -19,15 +18,16 @@ getDevices() ### 引数 -なし +なし。 ### 返値 {{DOMxRef("BluetoothDevice")}} の配列で解決する {{JSxRef("Promise")}} を返します。 -## 例外 +### 例外 -このメソッドは例外を投げません。 +- `SecurityError` {{domxref("DOMException")}} + - : 現在の文書へのアクセスが[セキュリティへの配慮](/ja/docs/Web/API/Web_Bluetooth_API#セキュリティへの配慮)のため、すなわち[権限ポリシー](/ja/docs/Web/HTTP/Permissions_Policy)の {{HTTPHeader("Permissions-Policy/bluetooth", "bluetooth")}} ディレクティブによってブロックされているときなどに、このコンテキストでこの処理が許可されていない場合に発生します。 ## 仕様書