This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The MIDIMessageEvent interface of the Web MIDI API represents the event passed to the onmidimessage event handler of the MIDIInput interface. A midimessage event is fired every time a MIDI message is sent from a device represented by a MIDIInput, for example when a MIDI keyboard key is pressed, a knob is tweaked, or a slider is moved.
Constructor
MIDIMessageEvent.MIDIMessageEvent- Creates a new
MIDIMessageEventobject instance.
Properties
MIDIConnectionEvent.data- A
Uint8Arraycontaining the data bytes of a single MIDI message. See the MIDI specification for more information on its form.
Note: Even though the Web MIDI API specifies a receivedTime property that returns a DOMHighResTimeStamp, Chrome (the only implementation at the time of writing) does not support that property since the basic Event.timeStamp property already returns a DOMHighResTimeStamp in Chrome.
Examples
// Printing all messages to console
navigator.requestMIDIAccess().then(midiAccess => {
Array.from(midiAccess.inputs).forEach(input => {
input[1].onmidimessage = console.log;
})
});
Specifications
| Specification | Status | Comment |
|---|---|---|
| Web MIDI API The definition of 'MIDIMessageEvent' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
MIDIMessageEvent | Chrome Full support 43 | Edge Full support ≤79 | Firefox ? | IE No support No | Opera Full support 30 | Safari ? | WebView Android No support No | Chrome Android Full support 43 | Firefox Android ? | Opera Android Full support 30 | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
MIDIMessageEvent() constructor | Chrome Full support 43 | Edge Full support ≤79 | Firefox ? | IE No support No | Opera Full support 30 | Safari ? | WebView Android No support No | Chrome Android Full support 43 | Firefox Android ? | Opera Android Full support 30 | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
data | Chrome Full support 43 | Edge Full support ≤79 | Firefox ? | IE No support No | Opera Full support 30 | Safari ? | WebView Android No support No | Chrome Android Full support 43 | Firefox Android ? | Opera Android Full support 30 | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
