HIDConnectionEvent
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The HIDConnectionEvent
interface of the WebHID API
represents HID connection events, and is the event type passed to HID.onconnect
and HID.ondisconnect
when an input report is received.
Constructor
HIDConnectionEvent()
-
Returns a new
HIDConnectionEvent
object. Typically this constructor is not used as events are created when an input report is received.
Properties
This interface also inherits properties from Event
.
HIDConnectionEvent.device
Read only-
Returns the
HIDDevice
instance representing the device associated with the connection event.
Examples
The following example registers event listeners for connect
and disconnect
events, then prints the HIDDevice.productName
to the console.
navigator.hid.addEventListener('connect', ({device}) => {
console.log(`HID connected: ${device.productName}`);
});
navigator.hid.addEventListener('disconnect', ({device}) => {
console.log(`HID disconnected: ${device.productName}`);
});
Specifications
Specification |
---|
WebHID API # dom-hidconnectionevent |
Browser compatibility
BCD tables only load in the browser