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.
Constructor
MIDIConnectionEvent()
-
Creates a new
MIDIConnectionEvent
object.
Instance 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.
js
navigator.requestMIDIAccess().then((access) => {
access.onstatechange = (event) => {
console.log(event.port.name, event.port.manufacturer, event.port.state);
};
});
Specifications
Specification |
---|
Web MIDI API # midiconnectionevent-interface |
Browser compatibility
BCD tables only load in the browser