Bluetooth: getAvailability() メソッド

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

getAvailability() は Bluetooth インターフェイスのメソッドで、（端末に Bluetooth アダプターがあるために）ユーザーエージェントが Bluetooth に対応する場合は実質的に true を返し、そうでない場合は false を返します。

もし Web Bluetooth API を使用する権限が Permissions-Policy: bluetooth 権限によって許可されていない場合、このメソッドは常に false を返すため、「実質的に」という言葉を使用しています。さらに、ユーザーはブラウザーが動作可能な Bluetooth アダプターを持っている場合でも、getAvailability() の呼び出しで false を返すように構成することができます。その逆も同様です。アクセスがその権限によってブロックされている場合、この設定値は無視されます。

getAvailability() が true を返し、端末に実際に Bluetooth アダプターがある場合でも、navigator.bluetooth.requestDevice() が BluetoothDevice で解決しないかもしれません。 Bluetooth アダプタに電源が供給されていない可能性や、ユーザーがプロンプトが表示されたときに API を使用する権限を拒否する可能性があります。

構文

getAvailability()

navigator.bluetooth.getAvailability().then((available) => {
  if (available) {
    console.log("この端末は Bluetooth に対応しています！");
  } else {
    console.log("残念！Bluetooth に対応していません");
  }
});