Serial: getPorts() 方法

可用性有限

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

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

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

注意：此功能在專用 Web Workers 中可用。

Serial 介面的 getPorts() 方法返回一個 Promise，該 Promise 解析為一個 SerialPort 物件陣列，表示已連線到主機並且源（origin）有權訪問的序列埠。

語法

getPorts()

無。

一個 Promise，解析為 SerialPort 物件陣列。

SecurityError DOMException

在以下任一情況下，返回的 Promise 會被拒絕並顯示此錯誤：

以下示例使用 getPorts() 來初始化可用埠列表。

navigator.serial.getPorts().then((ports) => {
  // Initialize the list of available ports with `ports` on page load.
});

規範
Web Serial API # dom-serial-getports

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