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()
引数
なし
返値
論理値で解決する Promise
を返します。
この Promise
は、Permissions-Policy: bluetooth
によってアクセスが許可されていない場合、ユーザーが常に false
で解決するようにブラウザーが構成されている場合、または端末に Bluetooth アダプターがない場合に false
の値を持ちます。
そうでない場合は true
で解決されます。
例外
なし。
例
以下のスニペットは、Bluetooth に端末が対応しているかどうかを指定するメッセージをコンソールに出力します。
navigator.bluetooth.getAvailability().then((available) => {
if (available) {
console.log("この端末は Bluetooth に対応しています!");
} else {
console.log("残念!Bluetooth に対応していません");
}
});
仕様書
Specification |
---|
Web Bluetooth # dom-bluetooth-getavailability |
ブラウザーの互換性
BCD tables only load in the browser