The getPorts() method of the Serial interface returns a Promise that resolves with an array of SerialPort objects representing serial ports connected to the host which the origin has permission to access.

None.

A Promise that resolves with an array of SerialPort objects.

SecurityError DOMException

The returned Promise rejects with this error if a Permissions Policy blocks the use of this feature or a user permission prompt was denied.

The following example uses getPorts() to initialize a list of available ports.

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