TheMIDIAccess interface of theWeb MIDI API provides methods for listing MIDI input and output devices, and obtaining access to those devices.

MIDIAccess is atransferable object.

Instance properties

MIDIAccess.inputsRead only

Returns an instance ofMIDIInputMap which provides access to any available MIDI input ports.

MIDIAccess.outputsRead only

Returns an instance ofMIDIOutputMap which provides access to any available MIDI output ports.

MIDIAccess.sysexEnabledRead only

A boolean attribute indicating whether system exclusive support is enabled on the current MIDIAccess instance.

Events

statechange

Called whenever a new MIDI port is added or an existing port changes state.

Examples

TheNavigator.requestMIDIAccess() method returns a promise that resolves with aMIDIAccess object. Information about the input and output ports is returned.

When a port changes state, information about that port is printed to the console.

navigator.requestMIDIAccess().then((access) => {  // Get lists of available MIDI controllers  const inputs = access.inputs.values();  const outputs = access.outputs.values();  access.onstatechange = (event) => {    // Print information about the (dis)connected MIDI controller    console.log(event.port.name, event.port.manufacturer, event.port.state);  };});

Specifications

Browser compatibility