Bluetooth: getDevices() メソッド

Limited availability

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

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

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

getDevices() は Bluetooth インターフェイスのメソッドで、このオリジンがアクセスを許可されている Bluetooth 機器を含む配列を返します。圏外だったり電源が切られていたりするものを含みます。

構文

js
getDevices()

引数

なし。

返値

BluetoothDevice の配列で解決する Promise を返します。

例外

SecurityError DOMException

現在の文書へのアクセスがセキュリティへの配慮のため、すなわち権限ポリシーの bluetooth ディレクティブによってブロックされているときなどに、このコンテキストでこの処理が許可されていない場合に発生します。

仕様書

Specification
Web Bluetooth
# dom-bluetooth-getdevices

ブラウザーの互換性

BCD tables only load in the browser