Serial: getPorts() method
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
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.
Syntax
js
getPorts()
Parameters
None.
Return value
A Promise that resolves with an array of SerialPort objects.
Exceptions
SecurityErrorDOMException-
The returned
Promiserejects with this error if a Permissions Policy blocks the use of this feature or a user permission prompt was denied.
Examples
The following example uses getPorts() to initialize a list of available ports.
js
navigator.serial.getPorts().then((ports) => {
// Initialize the list of available ports with `ports` on page load.
});
Specifications
| Specification |
|---|
| Web Serial API # dom-serial-getports |
Browser compatibility
BCD tables only load in the browser