This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The MIDIAccess interface of the Web MIDI API provides methods for listing MIDI input and output devices, and obtaining access to those devices.
Properties
MIDIAccess.inputsRead only- Returns an instance of
MIDIInputMapwhich provides access to any available MIDI input ports. MIDIAccess.outputsRead only- Returns an instance of
MIDIOutputMapwhich 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.
Event Handlers
MIDIAccess.onstatechange- Called whenever a new MIDI port is added or an existing port changes state.
Examples
navigator.requestMIDIAccess()
.then(function(access) {
// Get lists of available MIDI controllers
const inputs = access.inputs.values();
const ouputs = access.outputs.values();
access.onstatechange = function(e) {
// Print information about the (dis)connected MIDI controller
console.log(e.port.name, e.port.manufacturer, e.port.state);
};
});
Specifications
| Specification | Status | Comment |
|---|---|---|
| Web MIDI API | Working Draft | Initial definition. |