HID: getDevices() 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 getDevices() method of the HID interface gets a list of the connected HID devices that the user has previously been granted access to in response to a requestDevice() call.

Syntax

getDevices()

Parameters

None.

Return value

A Promise that resolves with a list of HIDDevice objects.

Examples

The following example gets a list of devices and logs the device names to the console.

document.addEventListener("DOMContentLoaded", async () => {
  let devices = await navigator.hid.getDevices();
  devices.forEach((device) => {
    console.log(`HID: ${device.productName}`);
  });
});

Specifications

Specification
WebHID API # dom-hid-getdevices

Browser compatibility

BCD tables only load in the browser