USB: getDevices() method
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
The getDevices method of the USB interface
returns a Promise that resolves with an array of USBDevice
objects for paired attached devices. For information on pairing devices, see
USB.requestDevice().
Syntax
getDevices()
Parameters
None.
Return value
Examples
The following example logs the product name and serial number of paired devices to the
console. For information on pairing devices, see
USB.requestDevice().
navigator.usb.getDevices().then((devices) => {
console.log(`Total devices: ${devices.length}`);
devices.forEach((device) => {
console.log(
`Product name: ${device.productName}, serial number ${device.serialNumber}`,
);
});
});
Specifications
| Specification |
|---|
| WebUSB API # dom-usb-getdevices |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
getDevices
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.