MIDIPort: connection property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The connection read-only property of the MIDIPort interface returns the connection state of the port.

Value

Returns a string containing the connection state of the port, one of:

"open"

The device that this MIDIPort represents has been opened and is available.

"closed"

The device that this MIDIPort represents has not been opened, or has been closed.

"pending"

The device that this MIDIPort represents has been opened but has subsequently disconnected.

Examples

The following example loops through all input ports and prints the connection status of each to the console.

js
for (const entry of midiAccess.inputs) {
  const input = entry[1];
  console.log(input.connection);
}

Specifications

Specification
Web MIDI API
# dom-midiport-connection

Browser compatibility

desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
connection