Bluetooth：getDevices() 方法

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

Bluetooth 介面的 getDevices() 方法返回一個數組，其中包含此源有權訪問的藍牙裝置——包括那些超出範圍和已關機的裝置。

語法

getDevices()

無。

一個 Promise，它將解析為一個 BluetoothDevice 物件陣列。

SecurityError DOMException: 如果由於安全方面的考慮（例如，在 Permissions Policy 指令 bluetooth 阻止對當前文件的訪問時呼叫）在此上下文中不允許此操作，則會丟擲此異常。

規範
Web 藍牙 # dom-bluetooth-getdevices

此頁面最後由 MDN 貢獻者於 2025 年 3 月 13 日修改。