dom / latest / midiconnectionevent.html /

MIDIConnectionEvent

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

The MIDIConnectionEvent interface of the Web MIDI API is the event passed to the statechange event of the MIDIAccess interface and the statechange event of the MIDIPort interface. This occurs any time a new port becomes available, or when a previously available port becomes unavailable. For example, this event is fired whenever a MIDI device is either plugged in to or unplugged from a computer.

Event MIDIConnectionEvent

Constructor

MIDIConnectionEvent()

Creates a new MIDIConnectionEvent object.

Properties

MIDIConnectionEvent.port Read only

Returns a reference to a MIDIPort instance for a port that has been connected or disconnected."

Examples

The Navigator.requestMIDIAccess() method returns a promise that resolves with a MIDIAccess object. When a port changes state, a MIDIConnectionEvent is passed to statechange event. Information about the port can then be printed to the console.

navigator.requestMIDIAccess()
  .then(function(access) {

     access.onstatechange = event => {
       console.log(event.port.name, event.port.manufacturer, event.port.state);
     };
  });

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
MIDIConnectionEvent
43
79
100
97-100
No
30
No
43
43
No
30
No
4.0
MIDIConnectionEvent
43
79
100
97-100
No
30
No
43
43
No
30
No
4.0
port
43
79
100
97-100
No
30
No
43
43
No
30
No
4.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MIDIConnectionEvent