W3cubDocs

/Web APIs

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.

js

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.

js

navigator.requestMIDIAccess().then((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 108 No 30 No 43 43 No 30 No 4.0

© 2005–2023 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