dom / latest / midiaccess / statechange_event.html /

MIDIAccess: statechange event

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

The statechange event of the MIDIAccess interface is fired when a new MIDI port is added or when an existing port changes state.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

addEventListener('statechange', event => { });

onstatechange = event => { };

Event type

Event properties

MIDIConnectionEvent.port Read only

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

Example

The Navigator.requestMIDIAccess() method returns a promise that resolves with a MIDIAccess object. When a port changes state, information about that port is 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
statechange_event
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/MIDIAccess/statechange_event